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:support@mlsgrid.com
  type: Support
- url: mailto:info@mlsgrid.com
  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: info@apievangelist.com
  X: apievangelist
  url: https://apievangelist.com
specificationVersion: '0.16'