# Domain Group

> Domain Group (Domain Holdings Australia Ltd, trading as domain.com.au) is one half of
> Australia's residential property portal duopoly, alongside REA Group's realestate.com.au,
> and since 27 August 2025 a wholly owned subsidiary of CoStar Group. Domain runs a genuine
> self-serve public developer portal at developer.domain.com.au and publishes three
> machine-readable OpenAPI 3.0.4 documents covering agency, agent, listing, property,
> valuation, market-statistics and webhook surfaces, all served from api.domain.com.au
> behind API-key or OAuth 2.0 credentials.

Generated by API Evangelist on 2026-07-26. Domain publishes no llms.txt of its own
(https://developer.domain.com.au/llms.txt returns 404); this file is generated from
apis.yml and the artifacts in this repository.

Access model: sign up with GitHub, Google, or email and create a project. Two API packages
are granted immediately — Agents & Listings, and Properties & Locations. The other eleven
(Address Suggestions, Campaign reporting, Campaign preview, Listings Management,
Price Estimation, Property Enrichment, Property Package, PropertyRadar, Rental AVM,
Schools Data, Webhooks) are added per project and negotiated with an account manager.
Write access to listings is broker-gated: sandbox sign-off by email to api@domain.com.au
plus written permission from the principal agent of each agency.

## Specs

- [OpenAPI latest (combined v1+v2, 108 operations)](https://developer.domain.com.au/static/latest/media/latest/openapi.json): OpenAPI 3.0.4. Local copy: openapi/domain-group-openapi-latest.json
- [OpenAPI v1 (93 operations)](https://developer.domain.com.au/static/latest/media/v1/openapi.json): OpenAPI 3.0.4. Local copy: openapi/domain-group-openapi-v1.json
- [OpenAPI v2 (20 operations)](https://developer.domain.com.au/static/latest/media/v2/openapi.json): OpenAPI 3.0.4. Local copy: openapi/domain-group-openapi-v2.json
- [OpenID Connect discovery](https://auth.domain.com.au/v1/.well-known/openid-configuration): identity metadata for the auth host. Local copy: well-known/domain-group-openid-configuration.json
- [JWKS](https://auth.domain.com.au/v1/.well-known/jwks): signing keys. Local copy: well-known/domain-group-jwks.json

## APIs

- [Address Suggestions](https://developer.domain.com.au/docs/latest/apis/pkg_address_suggestion): resolve free-text Australian addresses to Domain property ids.
- [Agents & Listings](https://developer.domain.com.au/docs/latest/apis/pkg_agents_listings): agencies, agents, residential/commercial/business/project listings, enquiries. Granted on signup.
- [Properties & Locations](https://developer.domain.com.au/docs/latest/apis/pkg_properties_locations): property records, location profiles, auction and sales results, suburb performance and demographics. Granted on signup.
- [Price Estimation](https://developer.domain.com.au/docs/latest/apis/pkg_price_estimation): automated sale price estimate with lower/mid/upper band and confidence.
- [Rental AVM](https://developer.domain.com.au/docs/latest/apis/pkg_rental_avm): automated rental estimates.
- [Property Enrichment](https://developer.domain.com.au/docs/latest/apis/pkg_property_enrichment): extra Domain-held property detail, features, zoning and perils.
- [Property Package](https://developer.domain.com.au/docs/latest/apis/pkg_property): bundled comprehensive property coverage.
- [PropertyRadar](https://developer.domain.com.au/docs/latest/apis/pkg_propertyradar): watchlist portfolios of properties, including G-NAF address lookup.
- [Schools Data](https://developer.domain.com.au/docs/latest/apis/pkg_schools_data): Australian schools by id or by latitude/longitude.
- [Listings Management](https://developer.domain.com.au/docs/latest/apis/pkg_listing_management): the CRM upload surface — create and update listings, read enquiries and processing reports. Broker-authorised.
- [Campaign API](https://developer.domain.com.au/docs/latest/apis/pkg_campaign_api): advertising campaign performance for listings and projects. Media agencies only.
- [Campaign API Preview](https://developer.domain.com.au/docs/latest/apis/pkg_campaign_api_preview): early-access channel of the Campaign API.
- [Webhooks](https://developer.domain.com.au/docs/latest/apis/pkg_webhooks): push notifications for agency, agent, enquiry, listing, project and listing-processing-report changes, plus a heartbeat.

## Docs

- [Developer portal](https://developer.domain.com.au/)
- [Documentation home](https://developer.domain.com.au/docs/latest)
- [Getting started](https://developer.domain.com.au/docs/latest/getting-started)
- [Create your first project](https://developer.domain.com.au/docs/latest/getting-started/creating-first-project)
- [Authentication](https://developer.domain.com.au/docs/latest/authentication): API key (x-api-key header) or OAuth 2.0. OAuth is required for any user-specific data.
- [Conventions](https://developer.domain.com.au/docs/latest/conventions)
- [Access](https://developer.domain.com.au/docs/latest/conventions/access): production https://api.domain.com.au/, auth https://auth.domain.com.au/
- [Versioning](https://developer.domain.com.au/docs/latest/conventions/versioning): URI-path versioning (v1, v2); deprecated endpoints stay usable but drop out of "latest" docs.
- [Sandbox](https://developer.domain.com.au/docs/latest/conventions/sandbox): https://api.domain.com.au/sandbox/ — write testing only, data refreshed every Sunday.
- [Pagination](https://developer.domain.com.au/docs/latest/conventions/pagination): pageNumber/pageSize, first page 1, default 20, max 100, X-Total-Count header.
- [Rate limiting](https://developer.domain.com.au/docs/latest/conventions/rate-limiting): 1000–3000 req/min by plan, per-package daily quota reset at 10am AEST, 429 with Retry-After and X-Quota-Exceeded.
- [Libraries](https://developer.domain.com.au/docs/latest/libraries): no prebuilt SDKs — generate your own from the OpenAPI documents.
- [Troubleshooting](https://developer.domain.com.au/docs/latest/troubleshooting): the X-Domain-Security-Reason header names the cause of 401/403.
- [Support](https://developer.domain.com.au/docs/latest/support): api@domain.com.au
- [SLA](https://developer.domain.com.au/docs/latest/support/sla): 99% uptime rolling month, 95th-percentile response within 900ms.
- [Terms and conditions](https://www.domain.com.au/group/api-terms-and-conditions/)
- [Attribution and usage policies](https://www.domain.com.au/group/copyright-notices-3rdparty-terms/)

## API Evangelist artifacts

- authentication/domain-group-authentication.yml — API key + OAuth 2.0 profile
- scopes/domain-group-scopes.yml — the 25 public api_* OAuth scopes
- conventions/domain-group-conventions.yml — pagination, rate limits, format, casing, error envelope
- errors/domain-group-problem-types.yml — error classes, diagnostic headers, OAuth and webhook error causes
- lifecycle/domain-group-lifecycle.yml — versioning, deprecation, SLA, status-page posture
- sandbox/domain-group-sandbox.yml — sandbox environment and promotion process
- asyncapi/domain-group-webhooks.yml — webhook event catalog
- asyncapi/domain-group-webhooks-asyncapi.yml — AsyncAPI 3.0.0 rendering of that catalog
- data-model/domain-group-data-model.yml — entity graph derived from 409 component schemas
- conformance/domain-group-conformance.yml — standards posture, including the RESO answer
- packages/domain-group-packages.yml — SDK posture (none first-party) and generation path
- mcp/domain-group-mcp.yml — derived candidate MCP tool surface (Domain publishes no MCP server)
- agentic-access/domain-group-agentic-access.yml — recommended x-agentic-access contracts
- security/domain-group-domain-security.yml — TLS/DNS posture
- well-known/domain-group-well-known.yml — /.well-known/ probe index
- skills/ — five packaged agent skills grounded in real operationIds
- overlays/ — OpenAPI Overlay 1.0.0 files carrying these enhancements

## Notes for agents

- Everything is JSON over HTTPS, camelCase, except OAuth/OIDC requests which are snake_case.
- Read endpoints with many optional parameters are POST, not GET, to avoid URI length limits.
- There is NO idempotency key. Write retries are not idempotent by contract; the listing
  upserts are keyed on your own agency reference, so retry the same reference, never a new one.
- No public status page (the Atlassian Statuspage for Domain is inactive), no dated changelog,
  no CLI, no embedded UI components, no GraphQL, no gRPC, and no MCP server.
- No RESO Web API or Data Dictionary certification, no OData $metadata, no MLS/IDX surface,
  and no Universal Property Identifier. RESO is a North American standard with no presence in
  the Australian portal duopoly. Properties carry opaque Domain ids; PropertyRadar also
  accepts the Australian G-NAF address identifier.
- All data is licensed under the Domain Group API Terms and Conditions. Attribution is required.