National Association of REALTORS

aid: nar
url: https://raw.githubusercontent.com/api-evangelist/nar/refs/heads/main/apis.yml
name: National Association of REALTORS
kind: company
description: 'The National Association of REALTORS (NAR) is the largest trade association in the United States, representing
  roughly one million members across residential and commercial real estate. NAR is the industry body that sits above the
  roughly 500 local Multiple Listing Services, and it is the reason the US residential market has a machine-readable contract
  at all: MLS Policy Statement 7.90 requires MLS organizations owned and operated by associations of REALTORS to implement
  the RESO Data Dictionary and the RESO Web API and to stay current within one year of each ratification, with compliance
  demonstrated through the RESO Certification Process. NAR mandates that standard rather than operating it - RESO is a separate
  organization, and the listing data behind every certified endpoint is licensed through MLS membership, an IDX or VOW agreement,
  a broker relationship, or a reseller. NAR itself holds no RESO certification and publishes no self-serve developer portal.
  Its own API surface is REALTORS M1, the members-first engagement system that replaces NRDS: the M1 Gateway External API
  is a live, HTTP-Basic-authenticated REST API over member, office, association and data-extract records, whose Swagger 2.0
  definition and Postman collection NAR publishes openly on GitHub for external association management system vendors and
  NAR partners, but whose credentials NAR issues only under a partner relationship.'
image: https://avatars.githubusercontent.com/u/7168861?v=4
tags:
- Real Estate
- United States
- Industry Body
- MLS
- RESO
- Standards
- Membership
- Property Listings
- IDX
- PropTech
created: '2026-07-26'
modified: '2026-07-26'
specificationVersion: '0.19'
apis:
- aid: nar:nar-m1-gateway-external-api
  name: REALTORS M1 Gateway External API
  description: The external surface of NAR's REALTORS M1 Gateway - the members-first engagement system that is the single
    source of truth for REALTOR member data across state and local associations. The published Swagger 2.0 definition documents
    64 paths under /ext/ covering Association, Member, Member Address, Certification, Code of Ethics, Demographic, Designation,
    Dues Payment, Education, Email, Fair Housing, Field of Business, ISC Affiliation, Language, MLS, Military Service, Phone,
    Secondary and Single-Owned MLS records, plus Office, Office Secondary, Data Extract Request and Data Extract Schedule.
    All calls require HTTP Basic authentication with environment-specific credentials issued by NAR; PATCH operations use
    a test/replace JSON Patch pattern where the test value must match the current stored value. The definition and a Postman
    collection are published openly by NAR on GitHub for external AMS vendors and NAR partners; the API host itself answers
    401 without credentials and enforces a documented rate limit.
  humanURL: https://github.com/NationalAssociationOfRealtors/M1-Developer-Guide-Supplemental-Docs
  baseURL: https://m1gateway.realtor
  tags:
  - Real Estate
  - Membership
  - Associations
  - Members
  - Offices
  - United States
  properties:
  - type: OpenAPI
    url: openapi/nar-m1-gateway-external-openapi.json
  - type: PostmanCollection
    url: collections/nar-m1-gateway-external.postman_collection.json
  - type: Documentation
    url: https://github.com/NationalAssociationOfRealtors/M1-Developer-Guide-Supplemental-Docs
  - type: Documentation
    url: https://www.nar.realtor/ae/manage-your-association/realtors-m1-members-first-engagement-system
  - type: Overlay
    url: overlays/nar-m1-gateway-external-overlay.yaml
  - type: Examples
    url: examples/nar-m1-gateway-external-examples.yml
common:
- type: DomainSecurity
  url: security/nar-domain-security.yml
- type: AgenticAccess
  url: agentic-access/nar-agentic-access.yml
- type: Authentication
  url: authentication/nar-authentication.yml
- type: Conventions
  url: conventions/nar-conventions.yml
- type: ErrorCatalog
  url: errors/nar-error-codes.yml
- type: RateLimits
  url: rate-limits/nar-rate-limits.yml
- type: Lifecycle
  url: lifecycle/nar-lifecycle.yml
- type: Conformance
  url: conformance/nar-conformance.yml
- type: DataModel
  url: data-model/nar-data-model.yml
- type: Packages
  url: packages/nar-packages.yml
- type: MCPServer
  url: mcp/nar-mcp.yml
- type: AgentSkill
  name: REALTORS M1 Gateway agent skills
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/nar-llms.txt
- type: Website
  url: https://www.nar.realtor/
- type: GitHubOrganization
  url: https://github.com/NationalAssociationOfRealtors
- type: LinkedIn
  url: https://www.linkedin.com/company/national-association-of-realtors
- type: Blog
  url: https://www.nar.realtor/blogs
- type: Newsroom
  url: https://www.nar.realtor/newsroom
- type: Policy
  url: https://www.nar.realtor/handbook-on-multiple-listing-policy/operational-issues-section-12-real-estate-transaction-standards-rets-policy-statement-790
- type: Policy
  url: https://www.nar.realtor/about-nar/policies/mls-policy/real-estate-transaction-standards-rets-web-api
- type: Documentation
  url: https://www.nar.realtor/real-estate-transaction-standards-rets
- type: Research
  url: https://www.nar.realtor/research-and-statistics
- type: Support
  url: https://www.nar.realtor/contact-us
- type: TermsOfService
  url: https://www.nar.realtor/terms-of-use
- type: PrivacyPolicy
  url: https://www.nar.realtor/privacy-policy
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com