mlsgrid

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
    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'