# Trestle (CoreLogic / Cotality)

> Trestle is the real estate data distribution platform operated by Cotality (formerly CoreLogic), sitting between roughly 500 US Multiple Listing Services and the technology providers, brokers and aggregators that consume their listing data. It maps each participating MLS into the RESO Data Dictionary 2.0 and republishes it through a RESO-Platinum-certified Web API 2.0 / OData 4.0 endpoint and a legacy RETS 1.8 endpoint, plus a bidirectional Direct Web API into the Matrix MLS CRM and a Participant Reporting API used to prove broker relationships back to the MLSs.

Generated by API Evangelist (https://apievangelist.com) on 2026-07-26 from the provider's public surface. Trestle publishes no /llms.txt of its own (HTTP 404 on trestle-documentation.corelogic.com/llms.txt and www.cotality.com/llms.txt).

## Read this first — the access gate

Trestle is fully documented and effectively uncallable without a contract. The documentation portal is public and needs no login, the OData service document answers anonymously with a 200, and the OAuth2 flow, quotas and every OData query convention are published openly. But the $metadata document and every entity set return 401. Credentials are issued only after a developer registers a Technology Provider or Broker account, requests a connection to each individual multiple listing organization, and completes an e-signed data licence contract that all parties sign — a contract most MLSs will only ratify if a licensed broker or agent sponsors it or the technology provider files periodic participant reports. There is no sandbox, no trial key and no public sample credential. Certification is not reachability.

## APIs

- [Trestle RESO Web API](https://trestle-documentation.corelogic.com/webapi.html): RESO Web API 2.0 / OData 4.0 at https://api.cotality.com/trestle/odata. 18 entity sets. OAuth2 client_credentials, scope=api, 8-hour Bearer token.
- [Trestle RETS](https://trestle-documentation.corelogic.com/rets.html): Legacy RETS 1.8 at https://api.cotality.com/trestle/rets. Session-less; HTTP Basic or OAuth2 with scope=rets. Digest auth explicitly unsupported.
- [Trestle Direct Web API](https://trestle-documentation.corelogic.com/direct-webapi-crm-reference.html): Bidirectional OData into the Matrix MLS database — Contacts, EmailHistory, Lists, PortalContents, SavedSearches, UserRegistry, DashboardAPI. OpenID Connect / Clareity SSO / HTTP Basic.
- [Trestle Participant Reporting API](https://trestle-documentation.corelogic.com/participant-reporting-api.html): POST and GET /trestle/report/TpParticipantReport — how technology providers evidence broker contracts to each MLS.

## Specs and machine-readable artifacts

- [OData service document](https://api.cotality.com/trestle/odata): anonymous, 200 — enumerates the 18 entity sets. Saved at openapi/trestle-odata-service-document.json.
- [OData $metadata (CSDL)](https://api.cotality.com/trestle/odata/$metadata): 401 — the real machine-readable contract is gated.
- [OpenID Connect discovery](https://api.cotality.com/trestle/oidc/.well-known/openid-configuration): anonymous, 200 — scopes, grants, endpoints. Saved at well-known/trestle-openid-configuration.json.
- [Postman collection](https://trestle-documentation.corelogic.com/samples/postman/trestle-webapi.json): "Trestle WebAPI Demonstration", 15 requests and 30 saved examples. Saved at postman/trestle-webapi.postman_collection.json.
- No OpenAPI or Swagger document exists anywhere on the Trestle or Cotality surface.
- No AsyncAPI, no webhooks, no events. Change capture is pull-based OData replication.
- No MCP server for Trestle. (Cotality operates one for a different product line: https://www.cotality.com/platforms/mcp-server)

## Resources (RESO Data Dictionary 2.0)

Property (761 fields, key ListingKey), Building (328), CustomProperty (144), Member (94), Office (82), Media (58), PropertyUnitTypes (54), Teams (50), OpenHouse (49), PropertyRooms (41), HistoryTransactional (31), TeamMembers (31), Field (15), Lookup (15), Model (8), plus DataSystem and Enumeration in the service document. Field-level metadata and enumerations are published anonymously at https://api.cotality.com/trestle/Documentation/MetaData/Resource/ and https://api.cotality.com/trestle/Documentation/MetaData/Enums.

## Conventions

- Pagination: OData $top (max 1000; 300,000 for key-only InKeyIndex queries) + $skip, or follow @odata.nextLink.
- Query: $filter, $select, $count, $expand, $apply=groupby() (partial).
- Trestle extensions: Replication=true (bulk endpoint, >1,000,000 records) and PrettyEnums=true (human-readable enum values).
- Change capture: filter on ModificationTimestamp (records) and PhotosChangeTimestamp (media, lives on Property). Deletions require periodic key-list reconciliation.
- Quotas: 7,200 queries/hour and 180/minute for the Web API; 18,000/hour and 480/minute for public media URLs. Headers Minute-Quota-Limit, Hour-Quota-Limit, Hour-Quota-ResetTime, QuotaType — returned even on a 401.
- Errors: OData error objects. 400 bad credentials/connection type, 401 no valid token, 404 not found or not licensed, 429 quota exceeded, 500 server error, 504 gateway timeout. Not RFC 9457.
- No idempotency key. No request-id header. No Sunset/Deprecation headers.

## Docs

- [Documentation index](https://trestle-documentation.corelogic.com/)
- [Getting started with WebAPI](https://trestle-documentation.corelogic.com/webapi.html)
- [WebAPI reference (OData)](https://trestle-documentation.corelogic.com/webapi-reference.html)
- [Growing to scale](https://trestle-documentation.corelogic.com/webapi-at-scale.html)
- [Client libraries — WebAPI](https://trestle-documentation.corelogic.com/webapi-libraries.html) (all third party; Trestle ships no first-party SDK)
- [Client libraries — RETS](https://trestle-documentation.corelogic.com/rets-libraries.html)
- [RETS Connector](https://trestle-documentation.corelogic.com/rets-connector.html)
- [Metadata browser](https://trestle-documentation.corelogic.com/metadata-reso.html)
- [FAQ](https://trestle-documentation.corelogic.com/faq.html)
- [Change log / release notes](https://trestle-documentation.corelogic.com/) — numbered Content Patches (currently #192, 2026-06-06) and Trestle 5.x release notes, each linked as a PDF.

## Company and commercial

- [Product page](https://www.cotality.com/products/trestle)
- [Sign up (Subscription Wizard)](https://trestle.corelogic.com/SubscriptionWizard)
- [Login](https://trestle.corelogic.com/Login)
- [Support](https://www.cotality.com/support) — trestlesupport@cotality.com; invite-only Slack at https://clgx-res.slack.com
- [Status](https://status.cotality.com) — Cotality US PagerDuty status page (company-wide, not Trestle-specific)
- [Responsible disclosure](https://www.cotality.com/legal/responsible-disclosure-policy) — Bugcrowd-hosted submission form
- [Terms of use](https://www.cotality.com/legal/terms-of-use) · [Privacy policy](https://www.cotality.com/legal/privacy-policy)
- No public pricing. Fees are per-MLS licence fees billed through the e-signing contract.

## Certifications

- RESO Web API — Platinum (https://www.reso.org/blog/corelogic-trestle-achieves-reso-platinum-certification-2/)
- RESO Data Dictionary v2.0 vendor certification, 2024-10-11
- RESO Universal Property Identifier (UPI) v2.0 — first multiple listing data distributor certified
- No SOC 2 / ISO 27001 / PCI DSS attestation is published anonymously; no trust center resolves.

## Migration notice

The API is moving to https://api.cotality.com. The legacy hosts api-prod.corelogic.com and api-trestle.corelogic.com are announced as deprecated with a committed 30-day notice; both still answered 200 on 2026-07-26.