MLS Grid (mlsgrid)

The MLS Grid is a normalized, RESO Data Dictionary compliant data distribution platform that gives brokers, MLSs, and application vendors a single OData v4 Web API and one master data license agreement covering 50+ participating MLSs across the United States. The MLS Grid Web API standardizes Property, Member, Office, OpenHouse, Media, and Lookup resources for IDX, VOW, broker-only, and product-testing use cases, replacing the per-MLS RETS feed sprawl that historically burdened real-estate technology vendors.

URL: Visit APIs.json

Run: Capabilities Using Naftiko

Tags

• Real Estate, MLS, RESO, OData, Property, Replication

Timestamps

• Created: 2026-05-25
• Modified: 2026-05-25

Tier

Tier 1 — Standards-aligned (RESO Data Dictionary + RESO Web API), documented rate limits, normalized multi-MLS surface, replication-optimized. See review.yml.

APIs

MLS Grid RESO Web API

Normalized, RESO-compliant OData v4 Web API for incremental replication of MLS listing data — Property, Member, Office, OpenHouse, Media, and Lookup. Authenticated with long-lived OAuth 2.0 bearer tokens. Optimized for bulk replication via $filter on OriginatingSystemName and ModificationTimestamp, with $expand of Media, Rooms, and UnitTypes inline on Property.

Base URL: https://api.mlsgrid.com/v2/

Human URL: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md

• Documentation — Master
• Documentation — API v2.0
• OData $metadata
• OpenAPI
• JSON Schema — Property
• JSON Schema — Media
• JSON-LD
• Naftiko Capability — Property Replication
• Naftiko Capability — Member Replication
• Naftiko Capability — Office Replication
• Naftiko Capability — OpenHouse Replication
• Naftiko Capability — Media Replication
• Naftiko Capability — Lookup Replication

Common Properties

• Portal — mlsgrid.com
• Documentation — docs.mlsgrid.com
• Documentation — Sitemap
• Documentation — RESO Data Dictionary
• Documentation — RESO Web API Specification
• GitHubOrganization
• Support — support@mlsgrid.com
• Contact — info@mlsgrid.com

Artifacts

Machine-readable API specifications organized by format.

OpenAPI

• MLS Grid RESO Web API

JSON Schema

• Property
• Media

JSON-LD

• MLS Grid Context

Capabilities (Naftiko)

• Property Replication
• Member Replication
• Office Replication
• OpenHouse Replication
• Media Replication
• Lookup Replication

Vocabulary

• MLS Grid Vocabulary

Spectral Rules

• MLS Grid Ruleset

Examples

• List Properties

Commercial artifacts

• Plans / Pricing
• Rate Limits
• FinOps Definition

Review

• Provider Review

Replication Pattern

All MLS Grid replication clients follow the same loop:

1. Filter every collection by OriginatingSystemName eq '<mls>' and ModificationTimestamp gt <watermark>.
2. Expand related resources where needed: $expand=Media,Rooms,UnitTypes on Property.
3. Page through @odata.nextLink until exhausted.
4. Persist the latest seen ModificationTimestamp as the new watermark.
5. Honor MlgCanView=false by retaining records but suppressing display.
6. Honor MlgCanUse to gate IDX, VOW, BO, and PT surfaces.
7. Download MediaURL payloads locally; never hot-link.

Rate Limits

Scope	Limit
Requests / second	2
Requests / hour	7,200
Requests / 24h	40,000
Download volume / hour	4 GB

Violations return HTTP 429 with suspension details; repeat offenders may have their token suspended. Exceptions are negotiated via support@mlsgrid.com.

Maintainers

FN: Kin Lane

Email: info@apievangelist.com