mlsgrid

The MLS Grid is a normalized, RESO-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. Built on the RESO Data Dictionary, the MLS Grid Web API standardizes Property, Member, Office, OpenHouse, Media, and Lookup resources for IDX, VOW, broker-only, and product-development use cases, replacing the per-MLS RETS feed sprawl that historically burdened real-estate technology vendors.

1 APIs 6 Capabilities 15 Features

mlsgrid publishes 1 API on the APIs.io network: MLS Grid RESO Web API.

The mlsgrid catalog on APIs.io includes 6 machine-runnable capabilities, 1 JSON-LD context, and 1 Spectral governance ruleset.

mlsgrid’s developer surface includes developer portal, documentation, support, and 15 more developer resources.

APIs

MLS Grid RESO Web API

Normalized, RESO Data Dictionary–compliant OData v4 Web API for incremental replication of MLS listing data — Property, Member, Office, OpenHouse, Media, and Lookup resources — ...

Capabilities

Run Capabilities with Naftiko — Deploy and orchestrate these API capabilities using Naftiko Fleet.

Run with Naftiko

Lookup Replication

Run with Naftiko

Media Replication

Run with Naftiko

Member Replication

Run with Naftiko

Office Replication

Run with Naftiko

Openhouse Replication

Run with Naftiko

Property Replication

Run with Naftiko

Run Capabilities with Naftiko — Deploy and orchestrate these API capabilities using Naftiko Fleet.

Run with Naftiko

Features

RESO Data Dictionary compliant entity model (Property, Member, Office, OpenHouse, Media, Lookup)

RESO Web API compliant OData v4 surface with $select, $filter, $expand, $top, $count, @odata.nextLink

Single Master Data License Agreement spanning all participating MLSs

OAuth 2.0 bearer-token authentication with long-lived tokens

Incremental replication via OriginatingSystemName + ModificationTimestamp pattern

$expand=Media,Rooms,UnitTypes for nested resource replication on Property

Standalone Media resource where the originating MLS permits (e.g. Northstar MLS)

All date fields normalized to UTC

Prefixed key fields (e.g. actris-1234567) to namespace records across MLSs

MlgCanView flag for license-driven retention and deletion handling

MlgCanUse array indicating allowed use cases (IDX, VOW, BO, PT)

50+ participating MLSs including ACTRIS, MRED, Northstar, NWMLS, REcolorado, MARIS, Heartland, Realtracs, OneKey

Quarterly compliance audits and centralized vendor management

Per-minute import cadence where the originating MLS permits

Documented rate limits (2 RPS, 7,200/hour, 40,000/24h, 4 GB/hour) with HTTP 429 on violation

Semantic Vocabularies

Mlsgrid Context

24 classes · 2 properties

JSON-LD

API Governance Rules

mlsgrid API Rules

5 rules · 2 errors 2 warnings 1 info

SPECTRAL

Resources

Documentation

Documentation

Documentation

Documentation

PrivacyPolicy

TermsOfService

GitHubOrganization

GitHubOrganization

Documentation

Documentation

SpectralRuleset

SpectralRuleset

Sources

aid: mlsgrid
url: https://raw.githubusercontent.com/api-evangelist/mlsgrid/refs/heads/main/apis.yml
apis:
- aid: mlsgrid:mlsgrid-reso-web-api
  name: MLS Grid RESO Web API
  tags:
  - Real Estate
  - MLS
  - RESO
  - OData
  - Property
  - Replication
  humanURL: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md
  baseURL: https://api.mlsgrid.com/v2/
  properties:
  - url: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md
    type: Documentation
  - url: https://docs.mlsgrid.com/master.md
    type: Documentation
  - url: https://api.mlsgrid.com/v2/$metadata
    type: Metadata
  - url: openapi/mlsgrid-reso-web-api-openapi.yml
    type: OpenAPI
  - url: json-schema/mlsgrid-property-schema.json
    type: JSONSchema
  - url: json-schema/mlsgrid-media-schema.json
    type: JSONSchema
  - url: json-ld/mlsgrid-context.jsonld
    type: JSONLD
  - type: NaftikoCapability
    url: capabilities/property-replication.yaml
  - type: NaftikoCapability
    url: capabilities/member-replication.yaml
  - type: NaftikoCapability
    url: capabilities/office-replication.yaml
  - type: NaftikoCapability
    url: capabilities/openhouse-replication.yaml
  - type: NaftikoCapability
    url: capabilities/media-replication.yaml
  - type: NaftikoCapability
    url: capabilities/lookup-replication.yaml
  description: Normalized, RESO Data Dictionary–compliant OData v4 Web API for incremental replication of MLS listing data — Property, Member, Office, OpenHouse, Media, and Lookup resources — across the participating MLS Grid boards. 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.
common:
- url: https://www.mlsgrid.com
  type: Portal
- url: https://docs.mlsgrid.com
  type: Documentation
- url: https://docs.mlsgrid.com/master.md
  type: Documentation
- url: https://docs.mlsgrid.com/api-documentation/api-version-2.0.md
  name: API Version 2.0
  type: Documentation
- url: https://docs.mlsgrid.com/sitemap.md
  name: Documentation Sitemap
  type: Documentation
- url: https://www.mlsgrid.com
  name: Resources and Guides
  type: Resources
- url: https://www.mlsgrid.com
  type: PrivacyPolicy
- url: https://www.mlsgrid.com
  type: TermsOfService
- url: mailto:[email protected]
  type: Support
- url: mailto:[email protected]
  type: Contact
- url: https://github.com/mlsgrid
  type: GitHubOrganization
- url: https://www.reso.org/data-dictionary/
  name: RESO Data Dictionary
  type: Documentation
- url: https://www.reso.org/reso-web-api/
  name: RESO Web API Specification
  type: Documentation
- url: plans/mlsgrid-plans-pricing.yml
  type: Plans
- url: rate-limits/mlsgrid-rate-limits.yml
  type: RateLimits
- url: finops/mlsgrid-finops.yml
  type: FinOps
- url: vocabulary/mlsgrid-vocabulary.yml
  type: Vocabulary
- url: rules/mlsgrid-rules.yml
  type: SpectralRuleset
- type: Features
  data:
  - RESO Data Dictionary compliant entity model (Property, Member, Office, OpenHouse, Media, Lookup)
  - RESO Web API compliant OData v4 surface with $select, $filter, $expand, $top, $count, @odata.nextLink
  - Single Master Data License Agreement spanning all participating MLSs
  - OAuth 2.0 bearer-token authentication with long-lived tokens
  - Incremental replication via OriginatingSystemName + ModificationTimestamp pattern
  - $expand=Media,Rooms,UnitTypes for nested resource replication on Property
  - Standalone Media resource where the originating MLS permits (e.g. Northstar MLS)
  - All date fields normalized to UTC
  - Prefixed key fields (e.g. actris-1234567) to namespace records across MLSs
  - MlgCanView flag for license-driven retention and deletion handling
  - MlgCanUse array indicating allowed use cases (IDX, VOW, BO, PT)
  - 50+ participating MLSs including ACTRIS, MRED, Northstar, NWMLS, REcolorado, MARIS, Heartland, Realtracs, OneKey
  - Quarterly compliance audits and centralized vendor management
  - Per-minute import cadence where the originating MLS permits
  - Documented rate limits (2 RPS, 7,200/hour, 40,000/24h, 4 GB/hour) with HTTP 429 on violation
  sources:
  - https://www.mlsgrid.com
  - https://docs.mlsgrid.com
  - https://docs.mlsgrid.com/master.md
  - https://docs.mlsgrid.com/api-documentation/api-version-2.0.md
  - https://docs.mlsgrid.com/sitemap.md
  updated: '2026-05-25'
created: '2026-05-25T00:00:00.000Z'
modified: '2026-05-25'
position: Consuming
description: The MLS Grid is a normalized, RESO-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. Built on the RESO Data Dictionary, the MLS Grid Web API standardizes Property, Member, Office, OpenHouse, Media, and Lookup resources for IDX, VOW, broker-only, and product-development use cases, replacing the per-MLS RETS feed sprawl that historically burdened real-estate technology vendors.
maintainers:
- FN: Kin Lane
  email: [email protected]
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'