REFERENCE

Listing status reference

Supported statuses and their evidence limits.

GET/api/v1/reference/statuses0 credits / call

Bearer authentication requiredJSON responseAccount-wide rate limits

MAKE IT YOUR OWN

Build a request

0 credits per call

Edit the parameters to generate a ready-to-use code example. No request runs until you select Send request. Python uses the requests package; PHP requires cURL; JavaScript examples run on your backend with Node.js 18 or later.

GET

Your API key kept only in this page’s memory

This request may consume 0 credits. Normal limits apply.

Example response

Illustrative structure, not a live property record. Fields may be null when the source has not supplied a value.

{
    "data": [
        {
            "value": "withdrawn",
            "meaning": "Explicit source withdrawal status only."
        },
        {
            "value": "no_longer_observed",
            "meaning": "Archived or removed observation, reason unconfirmed."
        }
    ],
    "meta": {
        "example": true,
        "credit_cost": 0
    }
}

Also available through MCP

Use the listingdata_statuses tool with the same documented inputs. Calls share your REST API credit balance and rate limits. Connect your MCP client →

Errors and retrying

Status	Meaning	Recommended handling
`400 / 422`	Invalid or unsupported parameters.	Correct the input using the error response.
`401 / 403`	Invalid key or ineligible account.	Check key status and account verification.
`404`	The requested record is not available.	Check the ID; do not infer a property’s status.
`402`	Monthly credit allowance exhausted.	Wait for the next UTC calendar month.
`429`	Minimum interval or daily request allowance exceeded.	Honour `Retry-After` and reset details.
`503`	A required data service is unavailable.	Back off and retry later. Service-side charges are refunded.

A deliberate public view

Property descriptions, internal search price bands and agent contact email or telephone numbers are never included. Source status and timestamps describe observations, not a guarantee of current availability. Future-dated source times are withheld. A record’s indexed_at is its last public index write; use the coverage endpoint for the last completed refresh cycle. Read the field policy.

ListingData API v1Inspect the OpenAPI contract ↗