aid: mls-grid url: https://raw.githubusercontent.com/api-evangelist/mls-grid/refs/heads/main/apis.yml name: MLS Grid kind: company description: >- The MLS Grid is a United States MLS data-distribution cooperative created by a network of Multiple Listing Services to give brokers, MLSs and technology vendors ONE normalized data feed, ONE license agreement and ONE compliance process instead of dozens of per-MLS RETS and Web API feeds. It ingests listing data from participating MLSs, converts it to the RESO Data Dictionary, and republishes it as a single RESO Web API (OData v4) replication surface at https://api.mlsgrid.com/v2/. It sits in the middle of the residential real estate value chain, between the MLSs that own the data and the IDX/VOW sites, portals and proptech applications that display it. Its API posture is the sector archetype: the documentation is genuinely public and complete, and MLS Grid is RESO-certified for Data Dictionary 2.0 and Web API Server Core 2.0.0 in the RESO certification directory (UOI T00000045) — but nothing is reachable without credentials. Every anonymous call to the service root, to /Property and to the OData $metadata document returns HTTP 401. Access requires the MLS Grid Master Data License Agreement plus approval by each originating MLS before a long-lived OAuth 2.0 bearer token is issued in the MLS Grid web application. Certified, documented, and closed. image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/mls-grid.png tags: - Real Estate - United States - MLS - RESO - Property Listings - IDX - PropTech - OData - Data Licensing created: '2026-07-26' modified: '2026-07-26' specificationVersion: '0.19' apis: - aid: mls-grid:mls-grid-web-api name: MLS Grid Web API v2 description: >- MLS Grid's RESO Web API — a replication-oriented OData v4 surface over listing data normalized to the RESO Data Dictionary and pooled from the participating MLSs. Documented entity sets are Property, Member, Office, OpenHouse and Lookup, with Media, Rooms and UnitTypes available through $expand (and Media standalone where the originating MLS permits). Replication is driven by $filter on OriginatingSystemName plus ModificationTimestamp, paged with @odata.nextLink. Authentication is a long-lived OAuth 2.0 bearer token issued through the MLS Grid web application after a subscription, a licensee and MLS approval are in place; the service requires an Accept-Encoding header containing gzip on every request. Documented rate limits are 2 requests/second, 7,200 requests/hour, 40,000 requests/24 hours and 4 GB/hour, enforced with HTTP 429 and token suspension. Probed anonymously on 2026-07-26: the service root, /Property and $metadata all returned HTTP 401, so no machine-readable contract could be downloaded. humanURL: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md baseURL: https://api.mlsgrid.com/v2/ tags: - Real Estate - MLS - RESO - OData - Property Listings - Replication properties: - type: Documentation url: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md - type: Documentation url: https://docs.mlsgrid.com/master.md - type: APIReference name: API Version 2.0 reference url: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md - type: GettingStarted name: MLS Grid Documentation — overview and how to start replicating url: https://docs.mlsgrid.com/master.md - type: Metadata url: https://api.mlsgrid.com/v2/$metadata - type: RateLimits name: Documented rate limits and data caps url: rate-limits/mls-grid-rate-limits.yml - type: Authentication name: Authentication profile url: authentication/mls-grid-authentication.yml - type: Conventions name: API conventions (OData replication semantics) url: conventions/mls-grid-conventions.yml - type: ErrorCatalog name: Error conditions and envelope url: errors/mls-grid-problem-types.yml - type: DataModel name: Entity model and relationships url: data-model/mls-grid-data-model.yml - type: Examples name: Documented request and response examples url: examples/_index.yml - type: LicenseAgreement url: https://www.mlsgrid.com/s/MLS-GRID-Data-License-Agreement.pdf - type: Support url: mailto:support@mlsgrid.com common: - type: DomainSecurity url: security/mls-grid-domain-security.yml - type: Website url: https://www.mlsgrid.com/ - type: Documentation url: https://docs.mlsgrid.com/ - type: Documentation name: Documentation index (llms.txt) url: https://docs.mlsgrid.com/llms.txt - type: Documentation name: Documentation sitemap url: https://docs.mlsgrid.com/sitemap.md - type: Portal name: MLS Grid web application (member login) url: https://app.mlsgrid.com/ - type: SignUp name: Interest form url: https://www.mlsgrid.com/interest-form - type: LicenseAgreement name: MLS Grid Data License Agreement (PDF) url: https://www.mlsgrid.com/s/MLS-GRID-Data-License-Agreement.pdf - type: FAQ url: https://www.mlsgrid.com/faq - type: Resources url: https://www.mlsgrid.com/resources - type: Overview url: https://www.mlsgrid.com/overview - type: About url: https://www.mlsgrid.com/whoisthemlsgrid - type: Customers name: Approved vendors url: https://www.mlsgrid.com/vendors - type: Blog name: News url: https://www.mlsgrid.com/news - type: Contact url: https://www.mlsgrid.com/contact-us - type: Support url: mailto:support@mlsgrid.com - type: GitHubOrganization url: https://github.com/mlsgrid - type: Certification name: RESO certification directory entry (UOI T00000045) url: https://certification.reso.org/summary/T00000045 - type: Certification name: RESO list of certified organizations url: https://www.reso.org/certificates/ - type: Documentation name: RESO Web API specification url: https://www.reso.org/reso-web-api/ - type: Documentation name: RESO Data Dictionary url: https://www.reso.org/data-dictionary/ - type: TermsOfService name: Terms of Use url: https://app.mlsgrid.com/termsofuse - type: PrivacyPolicy url: https://app.mlsgrid.com/privacypolicy - type: ChangeLog name: Release notices (per originating MLS) url: https://docs.mlsgrid.com/ - type: ChangeLog name: Structured changelog url: changelog/mls-grid-changelog.yml - type: Compliance name: RESO certification (Data Dictionary 2.0, Web API Server Core 2.0.0) url: https://certification.reso.org/summary/T00000045 - type: Conformance name: Standards conformance url: conformance/mls-grid-conformance.yml - type: Authentication url: authentication/mls-grid-authentication.yml - type: Conventions url: conventions/mls-grid-conventions.yml - type: ErrorCatalog url: errors/mls-grid-problem-types.yml - type: Lifecycle url: lifecycle/mls-grid-lifecycle.yml - type: DataModel url: data-model/mls-grid-data-model.yml - type: RateLimits url: rate-limits/mls-grid-rate-limits.yml - type: Vocabulary url: vocabulary/mls-grid-vocabulary.yml - type: Examples url: examples/_index.yml - type: Packages name: Client libraries (no first-party SDK) url: packages/mls-grid-packages.yml - type: LLMsTxt name: Documentation llms.txt (verbatim) url: llms/mls-grid-llms.txt maintainers: - FN: Kin Lane email: kin@apievangelist.com