> ## Documentation Index > Fetch the complete documentation index at: https://developers.investorlift.com/llms.txt > Use this file to discover all available pages before exploring further. # Read which data is available where > The coverage matrix of every loaded market, a place lookup by point, county, ZIP or market code, and the planned markets. One call answers three questions. Is this place covered? For which datasets? How fresh is each one? The answer is one row per dataset for every loaded market. With a place, the answer is the markets that cover it and what each dataset gives it there. The route reads the in-memory table behind `meta.coverage[]` and runs no query. Zero credits, any key. The same facts, recorded from production, are the [Coverage](/coverage/markets) pages and [`coverage.json`](/coverage.json). This route is the live answer for the host you call. ## Use it when * **Before a data call.** Ask if a point, a county or a ZIP is covered. Then you spend no metered call on a `422 outside_coverage`. Pass `lat` and `lng`, `county`, `zip` or `market`. Pass at most one of the four. * **To gate a screen per dataset.** A partner map or the Investorlift app reads `datasets..place_status` for the place. It then shows or hides the listing, short-term rental or lender panel. * **To say "planned" and not "not covered".** `data.planned[]` lists the markets under construction, as labelled intent. ## The vocabulary The keys of `datasets` are the datasets a market can lack. They are `deeds`, `listings`, `agents`, `wholesale`, `auction`, `str`, `parcels`, `financing`, `permits`, `owner_profile`, `history`, `cash_sale`, `lenders` and `addresses`. Each cell carries these fields. | Field | Meaning | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `status` | `served`: the API publishes the dataset for the whole market, or for every item of its scope that it can serve. `partial`: the API serves some items of the scope and not every item it can serve. `not_measured`: the build ran and the delivery cannot measure the fact. No build fixes it, so do not wait. `not_published`: the tables are absent or unbuilt. A later build fixes it, so wait. | | `dated` | The dataset is a snapshot valued at `as_of`. Every response that carries a value from it stamps `meta.dated[]`. The financing slice is dated, and so is the lender registry built from it. Independent of `status`: a dataset can be partial and dated at once. With `require_current`, a dated dataset answers `422 dated_refused`. | | `stale` | The as-of date failed its freshness rule against the clock of the request. Deeds follow the 45-day rule. Short-term rentals are stale when the feed of a served jurisdiction is stale this week. `null` where no rule exists, because a `false` reads as fresh. A dated set never refreshes. A stale one is late. | | `as_of` | The own date of the dataset. `null` where not published. Also `null` for the auction counts, which carry no date of their own. | | `gate` | For `not_published` and `not_measured`, the [error](/guides/concepts/errors) a call meets when it needs the dataset. `null` for `served` and `partial`. Each scope item then carries its own code. | | `granularity` | The grain of the dataset: `market`, `county` (deeds, lenders), `jurisdiction` (short-term rentals, permits) or `zip` (the history lake). | | `scope` | The list of items at that grain, with a status per item. Deeds: the counties with their deed ends. Lenders: every county and if the registry covers it. Short-term rentals: every jurisdiction with its `reason`. Permits: every issuer. History: every ZIP the lake covers. `null` for a market-grain dataset. | | `features` | Lenders only: the per-market `*_measured` flags of the registry. They are features of one dataset, not statuses. | | `place_status` | Present only when you gave a place. `served` or `outside` for the place at the grain of the dataset. `null` when the input cannot decide the grain. Examples: a lender or short-term rental answer from a bare point, or a jurisdiction from a ZIP or a county. | The history lake reads `partial` until a roster says how many ZIP codes a market has. A short-term rental jurisdiction that requires no licence reads `not_applicable` in the scope. It counts on neither side of the roll-up. ## The place lookup * **A point** (`lat`, `lng`). The API applies the bounding-box-and-tolerance rule of every data route (`bbox` and `point_tolerance_miles` on the row), so the two never disagree. * **A county** (`county=04021` or `county=Pinal`). The API matches it against the counties of the loaded markets. It then decides deeds and the lender registry at county grain. Pinal reads deeds `served` and lenders `outside` while the registry covers Maricopa alone. * **A ZIP** (`zip=85142`). The API resolves it to every county it touches, largest land share first (`place.counties`). The source is a committed copy of the public ZIP-to-county relationship file of the Census Bureau. The API then decides at county grain, and decides the history lake against its own ZIP set. A ZIP-universe market covers only its own ZIP codes. * **A market code** (`market=phx`). The API answers that row alone. An unknown code is `outside`, never `400`. A place nothing covers is **`200` with `data.markets: []` and `place.status: outside`, never `422`**. This is the one route that answers the question the data routes refuse. With a place, `meta.coverage[]` names the covering markets alone. A response outside every market carries an empty coverage list and no `X-Dataset-Version` header. ## Planned markets `data.planned[]` lists the markets Investorlift intends to serve and this host does not serve yet. Each row carries `label_kind: "intent"`. Intent, not a commitment: a market is covered when it appears in `data.markets[]` and in `meta.coverage[]` on your responses. The [Developer Agreement](/guides/terms) promises no refresh cadence and no continuity, and the list can change without notice. A code the host has loaded is never in this list. ## Gotchas * The `ETag` comes from the dataset versions of the markets in the answer, not from the query. Cache by URL. Send `If-None-Match` for a `304` when nothing moved. * Two place groups at once (`zip` beside `market`, for example) are `400 geometry_conflict`. So is `lat` without `lng`. * The concise MCP format of `godmode_coverage` caps the jurisdiction, issuer and ZIP lists at ten items. This route carries them whole. ## Related [`GET /v1/dataset`](/api-reference/endpoints/dataset) is the freshness probe: did the version move? This route answers what is covered where. [Coverage and freshness](/guides/concepts/coverage) explains `meta.coverage[]`, the block both routes read. The [Coverage](/coverage/markets) pages state the answer as recorded from production. ## OpenAPI ````yaml GET /v1/coverage openapi: 3.1.0 info: title: God Mode API version: 0.33.1 description: >- You have a house to sell, usually a wholesale contract. You want to know **who nearby buys houses like this one and how to reach them**. County deed records already hold the answer. This API reads them for each loaded market and serves three things: deals, investors and a ranking. On every response, `meta.coverage[]` lists the markets and the area each covers. **Deals** are every investment purchase, flip, wholesale and current investor holding. **Investors** are the buyers behind them, grouped so that the LLCs of an operator and the person behind them count as one. **A ranking** says, for a given house, which investors are the best fit and why. The documentation site at https://developers.investorlift.com carries the guides, the walkthroughs, the error catalogue and the connection steps for MCP clients. https://developers.investorlift.com/llms.txt indexes the site for a model. This document is the machine-readable reference behind the API tab of the site. **Start here.** Ranked buyers for a house at 7522 E Cholla St, Scottsdale, under contract at $410,000 and in need of a major rehab: ``` GET https://api.investorlift.com/v1/buyers/match?lat=33.476917&lng=-111.920385&radius_miles=2&subject_asking_price=410000&subject_condition=MAJOR_REHAB Authorization: Bearer zpka_... ``` **Conventions.** Responses are `{ data, meta }`. Lists add `page` (an opaque cursor) and sometimes `summary`. A list parameter takes commas or repeated keys. Dates are YYYY-MM-DD. Ids carry a prefix: `deal_`, `prop_`, `inv_`, `agt_`, `wl_`, `wsr_`. Money is whole dollars. It is null, never 0, when the deed carries no price. Coordinates are WGS84. A location is a point and radius (`lat`, `lng`, `radius_miles`), a viewport (`bbox=west,south,east,north`) or a parcel (`property_id`). This host does not serve the people behind an entity, mailing addresses, owner identity, mortgage borrowers or lien parties. It does not serve the names, phones, emails and licence numbers of listing agents. It serves the entities, the deals, the listings and the ranking. Errors are RFC 9457 problem+json with a `code` to switch on. The catalogue is https://developers.investorlift.com/problems.json and the Errors page of the site. The field `meta.coverage[].dataset_version` changes only when a refresh rebuilds the tables of a market. Use it in cache keys, or poll `GET /v1/dataset`. **MCP.** The API serves the same data to Model Context Protocol clients at `POST https://api.investorlift.com/mcp` with the same key: twenty-six read-only tools, four resources, seven prompts. The MCP tab of the documentation site has the client setup. The file `mcp-manifest.json` beside this document lists the tools with their input schemas. Problem codes: 400 validation_error, 400 unknown_parameter, 400 invalid_cursor, 400 geometry_required, 400 geometry_conflict, 400 sort_requires_point, 400 invalid_id, 400 market_required, 401 unauthorized, 403 quota_exceeded, 403 subscription_required, 403 payment_overdue, 403 plan_limit, 404 not_found, 406 not_acceptable, 410 gone, 422 outside_coverage, 422 ambiguous_apn, 422 ambiguous_address, 422 csv_cap_exceeded, 422 listings_unavailable, 422 agents_unavailable, 422 lenders_unavailable, 422 wholesale_unavailable, 422 str_unavailable, 422 cash_sale_unavailable, 422 auction_unavailable, 422 parcels_unavailable, 422 addresses_unavailable, 422 dated_refused, 422 history_unavailable, 400 quicklist_unavailable, 400 dataset_unavailable, 429 rate_limited, 500 internal_error, 503 database_unavailable, 503 pool_saturated, 503 ledger_unavailable, 504 statement_timeout. servers: - url: https://api.investorlift.com security: - bearerAuth: [] tags: - name: buyers x-group: Buyers description: >- Which investors are the best fit for this house: the API ranks nearby investors against a subject property and explains each score. - name: deals x-group: Deals description: >- What occurred around a location: deals for a table, cells for a map, summary stats, and one deal by id. - name: investors x-group: Investors description: >- Who the buyers are: investors active in an area, a full profile, and their metro-wide history. A search finds an investor by any name they buy under. - name: properties x-group: Properties description: >- One parcel: find it from a point or an APN, then read its facts, owner information, short-term rental licence and every deal on it. The owner information covers investor holdings and business-use short-term rentals. - name: agents x-group: Listing agents description: >- Who the listing agents are: find one by name or licence number, then read the profile and every listing of theirs. The profile holds the licence, the brokerages, the listing counts and the investors they belong to. - name: wholesale x-group: Investorlift listings description: >- Investorlift listings as wholesale transactions: the houses listed, and what the county deeds show for each (closed, to whom, which deed). Also the listing companies, and what each investor bought off Investorlift. - name: lenders x-group: Lenders description: >- Who lends on houses in a market: find a lender by any spelling of its name. Rank the lenders of a market, or of one ZIP, city or county. Read a profile: loans counted once across the open-lien and recorded-history tables, the open book, terms, geography and rankings. List every loan of one lender. - name: dataset x-group: Dataset and coverage description: >- What the API serves, how fresh it is and which data is available where. The dataset version and the last deed date of every market, for cache keys and freshness checks. The coverage matrix, with a place lookup. - name: contract x-group: By contract description: >- Routes sold per jurisdiction under an order form and not reachable on a self-serve key. Ask through the console. externalDocs: description: >- The documentation site: the guides, the walkthroughs, the error catalogue and the MCP connection steps. url: https://developers.investorlift.com paths: /v1/coverage: get: tags: - dataset summary: Read which data is available where description: >- Which data is available where. For every loaded market, one row per dataset with a status word and the as-of date. Each row carries the dated and stale flags and the error a call meets where the dataset is not served. The planned markets follow, as intent. Ask about a place with `lat` and `lng`, `county`, `zip` or `market`. The answer names the markets that cover it and what each dataset gives it. A place nothing covers answers 200, never 422. Zero credits. [The matrix vocabulary, the place lookup and the planned rows](https://developers.investorlift.com/api-reference/endpoints/coverage). operationId: getCoverage parameters: - schema: type: number minimum: -90 maximum: 90 in: query name: lat required: false description: >- With lng: the point to look up. The API decides the covering markets with the bounding-box-and-tolerance rule the data routes apply (meta.coverage[].bbox and point_tolerance_miles), so the two never disagree. - schema: type: number minimum: -180 maximum: 180 in: query name: lng required: false description: 'With lat: the point''s longitude.' - schema: type: string minLength: 1 maxLength: 64 in: query name: county required: false description: >- A county to look up: a 5-digit FIPS ("04021") or a name ("Pinal", "Pinal County", any case). The API matches it against the counties of the loaded markets and the states of the public ZIP-to-county crosswalk. Not with lat, lng, zip or market. - schema: type: string pattern: ^\d{5}$ in: query name: zip required: false description: >- A ZIP to look up. The API resolves it to every county it touches through the public ZIP-to-county crosswalk, largest land share first, then decides at county grain. A ZIP-universe market covers only its own ZIP codes. Not with lat, lng, county or market. - schema: type: string minLength: 1 maxLength: 16 in: query name: market required: false description: >- A market code to look up: its row alone. An unknown code answers place.status outside with markets [], never 400. Not with lat, lng, county or zip. responses: '200': description: The coverage matrix, the place lookup and the planned markets. content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/CoverageData' meta: $ref: '#/components/schemas/Meta' required: - data - meta additionalProperties: false description: The coverage matrix, the place lookup and the planned markets. example: data: markets: - market: phx state: AZ label: Phoenix metro stage: general universe_kind: metro universe_zips: null counties: - fips: '04013' name: Maricopa data_end: '2026-08-12' - fips: '04021' name: Pinal data_end: '2026-08-06' bbox: - -113.332773 - 32.46915 - -110.455491 - 33.999503 point_tolerance_miles: 20 n_parcels: 1836311 data_end: '2026-08-27' dataset_version: 1789605233 loaded_at: '2026-09-17T00:33:53.207Z' stale: false datasets: deeds: status: served dated: false stale: false as_of: '2026-08-27' gate: null granularity: county scope: kind: counties items: - key: '04013' name: Maricopa status: served gate: null as_of: '2026-08-12' reason: null regime: null feed_stale: null licence_start: null counts: null - key: '04021' name: Pinal status: served gate: null as_of: '2026-08-06' reason: null regime: null feed_stale: null licence_start: null counts: null features: null place_status: served listings: status: served dated: false stale: null as_of: '2026-09-07' gate: null granularity: market scope: null features: null place_status: served agents: status: served dated: false stale: null as_of: '2026-09-07' gate: null granularity: market scope: null features: null place_status: served wholesale: status: served dated: false stale: null as_of: '2026-09-09' gate: null granularity: market scope: null features: null place_status: served auction: status: served dated: false stale: null as_of: null gate: null granularity: market scope: null features: null place_status: served str: status: partial dated: false stale: false as_of: '2026-09-10' gate: null granularity: jurisdiction scope: kind: jurisdictions items: - key: APACHE_JUNCTION name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: AVONDALE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: BUCKEYE name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: CAREFREE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: CASA_GRANDE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: CAVE_CREEK name: null status: not_published gate: null as_of: null reason: LOADED_UNVALIDATED regime: REQUIRED feed_stale: true licence_start: '2023-11-06' counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: CHANDLER name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: CITY_OF_MARICOPA name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: COOLIDGE name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: EL_MIRAGE name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: ELOY name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: FLORENCE name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: FOUNTAIN_HILLS name: null status: not_published gate: null as_of: null reason: LOADED_UNVALIDATED regime: REQUIRED feed_stale: true licence_start: '2022-11-15' counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: GILA_BEND name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: GILBERT name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: GLENDALE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: GOODYEAR name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: GUADALUPE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: LITCHFIELD_PARK name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: MARICOPA_UNINCORPORATED name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: MESA name: null status: not_published gate: null as_of: '2026-09-10' reason: LOADED_COUNTS_ONLY regime: REQUIRED feed_stale: false licence_start: '2023-02-01' counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: PARADISE_VALLEY name: null status: not_published gate: null as_of: '2026-09-10' reason: LOADED_UNVALIDATED regime: REQUIRED feed_stale: false licence_start: '2022-11-13' counts: n_licensed: 95 n_pending: 0 n_expired: 0 n_advertised: 0 - key: PEORIA name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: PHOENIX name: null status: served gate: null as_of: '2026-09-10' reason: LOADED_SERVED regime: REQUIRED feed_stale: false licence_start: '2023-10-26' counts: n_licensed: 1750 n_pending: 0 n_expired: 0 n_advertised: 0 - key: PINAL_UNINCORPORATED name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: QUEEN_CREEK name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: SCOTTSDALE name: null status: served gate: null as_of: '2026-09-10' reason: LOADED_SERVED regime: REQUIRED feed_stale: false licence_start: '2022-11-28' counts: n_licensed: 2707 n_pending: 41 n_expired: 2 n_advertised: 671 - key: SURPRISE name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: TEMPE name: null status: not_published gate: null as_of: '2026-09-10' reason: LOADED_UNVALIDATED regime: REQUIRED feed_stale: false licence_start: '2023-03-06' counts: n_licensed: 110 n_pending: 0 n_expired: 0 n_advertised: 0 - key: TOLLESON name: null status: not_applicable gate: null as_of: null reason: NO_REQUIREMENT regime: NOT_REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: WICKENBURG name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 - key: YOUNGTOWN name: null status: not_published gate: null as_of: null reason: REQUIRED_NOT_PUBLISHED regime: REQUIRED feed_stale: false licence_start: null counts: n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 features: null place_status: null parcels: status: served dated: false stale: null as_of: '2026-08-27' gate: null granularity: market scope: null features: null place_status: served financing: status: served dated: true stale: null as_of: '2026-06-25' gate: null granularity: market scope: null features: null place_status: served permits: status: served dated: false stale: null as_of: '2026-09-01' gate: null granularity: jurisdiction scope: kind: jurisdictions items: - key: PHOENIX name: null status: served gate: null as_of: '2026-05-11' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 795764 - key: MESA name: null status: served gate: null as_of: '2026-05-29' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 330809 - key: MARICOPA COUNTY name: null status: served gate: null as_of: '2027-10-17' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 217628 - key: SCOTTSDALE name: null status: served gate: null as_of: '2024-11-05' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 182189 - key: GOODYEAR name: null status: served gate: null as_of: '2025-04-02' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 173391 - key: GILBERT name: null status: served gate: null as_of: '2025-04-07' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 160199 - key: TEMPE name: null status: served gate: null as_of: '2025-12-29' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 102909 - key: BUCKEYE name: null status: served gate: null as_of: '2026-03-18' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 94951 - key: CHANDLER name: null status: served gate: null as_of: '2026-05-29' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 94942 - key: PEORIA name: null status: served gate: null as_of: '2026-05-07' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 75435 - key: QUEEN CREEK name: null status: served gate: null as_of: '2026-04-24' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 59103 - key: '' name: null status: served gate: null as_of: '2026-06-05' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 43845 - key: PARADISE VALLEY name: null status: served gate: null as_of: '2026-04-24' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 23135 - key: AVONDALE name: null status: served gate: null as_of: '2026-04-24' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 7961 - key: MARICOPA name: null status: served gate: null as_of: '2026-12-12' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 5732 - key: YOUNGTOWN name: null status: served gate: null as_of: '2026-06-05' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 3979 - key: EL MIRAGE name: null status: served gate: null as_of: '2026-04-13' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1971 - key: YUMA name: null status: served gate: null as_of: '2009-01-15' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1909 - key: FOUNTAIN HILLS name: null status: served gate: null as_of: '2026-05-21' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 767 - key: ELMIRAGE name: null status: served gate: null as_of: '2025-08-08' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 521 - key: SUN CITY name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 133 - key: COCONINO COUNTY name: null status: served gate: null as_of: '2024-02-16' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 63 - key: PINAL COUNTY name: null status: served gate: null as_of: '2022-07-21' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 54 - key: APACHE JUNCTION name: null status: served gate: null as_of: '2025-05-13' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 47 - key: PIMA COUNTY name: null status: served gate: null as_of: '2016-10-24' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 21 - key: WITTMANN name: null status: served gate: null as_of: '2026-02-03' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 8 - key: JACKSON COUNTY name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 7 - key: LEWISVILLE name: null status: served gate: null as_of: '2024-02-07' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 5 - key: MONTGOMERY name: null status: served gate: null as_of: '2023-06-05' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 4 - key: RIVERSIDE COUNTY name: null status: served gate: null as_of: '2026-06-20' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 3 - key: LITCHFIELD PARK name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 3 - key: APACHE JUNCTION - SEWER UTILITY name: null status: served gate: null as_of: '2026-05-07' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 2 - key: FORT WORTH name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 2 - key: YAVAPAI COUNTY name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1 - key: LOCUST GROVE name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1 - key: ORO VALLEY name: null status: served gate: null as_of: null reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1 - key: TANGIPAHOA name: null status: served gate: null as_of: '2019-05-28' reason: null regime: null feed_stale: null licence_start: null counts: n_permits: 1 features: null place_status: null owner_profile: status: served dated: false stale: null as_of: '2026-09-09' gate: null granularity: market scope: null features: null place_status: served history: status: partial dated: false stale: null as_of: '2026-09-09' gate: null granularity: zip scope: kind: zips items: - key: '85251' name: null status: served gate: null as_of: '2026-09-09' reason: null regime: null feed_stale: null licence_start: null counts: null features: null place_status: served cash_sale: status: not_measured dated: false stale: null as_of: null gate: cash_sale_unavailable granularity: market scope: null features: null place_status: outside lenders: status: partial dated: true stale: null as_of: '2026-06-25' gate: null granularity: county scope: kind: counties items: - key: '04013' name: Maricopa status: served gate: null as_of: '2026-06-25' reason: null regime: null feed_stale: null licence_start: null counts: null - key: '04021' name: Pinal status: not_published gate: outside_coverage as_of: null reason: null regime: null feed_stale: null licence_start: null counts: null features: purchase_measured: true investor_lending_measured: true flips_measured: true borrowers_measured: true takebacks_measured: true counties_measured: false place_status: served addresses: status: served dated: false stale: null as_of: '2026-08-27' gate: null granularity: market scope: null features: null place_status: served place: input: kind: county value: '04013' status: covered markets: - phx counties: - fips: '04013' name: Maricopa planned: [] meta: generated_at: '2026-09-17T00:55:00.000Z' coverage: - market: phx state: AZ counties: - fips: '04013' name: Maricopa data_end: '2026-08-12' - fips: '04021' name: Pinal data_end: '2026-08-06' bbox: - -113.332773 - 32.46915 - -110.455491 - 33.999503 data_end: '2026-08-27' build_run_id: 3 registry_run: 11 registry_version: v6-auction dataset_version: 1789605233 loaded_at: '2026-09-17T00:33:53.207Z' metro_buy_to_resale_ratio: 0.719 universe_kind: metro universe_zips: null point_tolerance_miles: 20 n_parcels: 1836311 listings_data_end: '2026-09-07' agents_data_end: '2026-09-07' wholesale_as_of: '2026-09-09' str_as_of: '2026-09-10' str: jurisdictions: - name: APACHE_JUNCTION regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: AVONDALE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: BUCKEYE regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: CAREFREE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: CASA_GRANDE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: CAVE_CREEK regime: REQUIRED coverage_reason: LOADED_UNVALIDATED served: false snapshot_only: true licence_start: '2023-11-06' snapshot_date: null feed_stale: true sources: - source: DECKARD snapshot_date: null stale: false n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: CHANDLER regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: CITY_OF_MARICOPA regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: COOLIDGE regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: EL_MIRAGE regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: ELOY regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: FLORENCE regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: FOUNTAIN_HILLS regime: REQUIRED coverage_reason: LOADED_UNVALIDATED served: false snapshot_only: true licence_start: '2022-11-15' snapshot_date: null feed_stale: true sources: - source: DECKARD snapshot_date: null stale: false n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: GILA_BEND regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: GILBERT regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: GLENDALE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: GOODYEAR regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: GUADALUPE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: LITCHFIELD_PARK regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: MARICOPA_UNINCORPORATED regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: MESA regime: REQUIRED coverage_reason: LOADED_COUNTS_ONLY served: false snapshot_only: false licence_start: '2023-02-01' snapshot_date: '2026-09-10' feed_stale: false sources: - source: MESA snapshot_date: '2026-09-10' stale: false n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: PARADISE_VALLEY regime: REQUIRED coverage_reason: LOADED_UNVALIDATED served: false snapshot_only: false licence_start: '2022-11-13' snapshot_date: '2026-09-10' feed_stale: false sources: - source: PV snapshot_date: '2026-09-10' stale: false n_licensed: 95 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: 0.0104 share_assumed: null - name: PEORIA regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: PHOENIX regime: REQUIRED coverage_reason: LOADED_SERVED served: true snapshot_only: false licence_start: '2023-10-26' snapshot_date: '2026-09-10' feed_stale: false sources: - source: PHX_GIS snapshot_date: '2026-09-10' stale: false - source: PHX_SHAPE snapshot_date: null stale: true n_licensed: 1750 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: 0.0793 share_assumed: 0 - name: PINAL_UNINCORPORATED regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: QUEEN_CREEK regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: SCOTTSDALE regime: REQUIRED coverage_reason: LOADED_SERVED served: true snapshot_only: false licence_start: '2022-11-28' snapshot_date: '2026-09-10' feed_stale: false sources: - source: COS_EXPIRED snapshot_date: '2026-09-10' stale: false - source: COS_LEGACY snapshot_date: '2026-09-10' stale: false - source: COS_LICENSED snapshot_date: '2026-09-10' stale: false - source: COS_PENDING snapshot_date: '2026-09-10' stale: false - source: COS_STAFF snapshot_date: '2026-09-10' stale: false - source: COS_UNLICENSED snapshot_date: '2026-09-10' stale: false n_licensed: 2707 n_pending: 41 n_expired: 2 n_advertised: 671 share_unmatched: 0.0267 share_assumed: 0.0004 - name: SURPRISE regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: TEMPE regime: REQUIRED coverage_reason: LOADED_UNVALIDATED served: false snapshot_only: false licence_start: '2023-03-06' snapshot_date: '2026-09-10' feed_stale: false sources: - source: TEMPE snapshot_date: '2026-09-10' stale: false n_licensed: 110 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: 0.676 share_assumed: null - name: TOLLESON regime: NOT_REQUIRED coverage_reason: NO_REQUIREMENT served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: WICKENBURG regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null - name: YOUNGTOWN regime: REQUIRED coverage_reason: REQUIRED_NOT_PUBLISHED served: false snapshot_only: false licence_start: null snapshot_date: null feed_stale: false sources: [] n_licensed: 0 n_pending: 0 n_expired: 0 n_advertised: 0 share_unmatched: null share_assumed: null auction_counted: true parcel_as_of: '2026-08-27' address_as_of: '2026-08-27' parcel: parcel_as_of: '2026-08-27' n_parcels: 1836311 sale_mortgage_measured: false financing: as_of: '2026-06-25' dated: true dated_reason: dataset not in current delivery n_parcels: 1611957 n_with_open_lien: 1032808 n_free_and_clear: 579149 n_avm: 1528967 n_involuntary: 192400 n_lenders: 76212 permits: as_of: '2026-09-01' n_permits: 2377496 n_parcels: 663045 n_unmatched: 355 jurisdictions: - jurisdiction: PHOENIX n_permits: 795764 last_issue_date: '2026-05-11' windows_measured: null - jurisdiction: MESA n_permits: 330809 last_issue_date: '2026-05-29' windows_measured: null - jurisdiction: MARICOPA COUNTY n_permits: 217628 last_issue_date: '2027-10-17' windows_measured: null - jurisdiction: SCOTTSDALE n_permits: 182189 last_issue_date: '2024-11-05' windows_measured: null - jurisdiction: GOODYEAR n_permits: 173391 last_issue_date: '2025-04-02' windows_measured: null - jurisdiction: GILBERT n_permits: 160199 last_issue_date: '2025-04-07' windows_measured: null - jurisdiction: TEMPE n_permits: 102909 last_issue_date: '2025-12-29' windows_measured: null - jurisdiction: BUCKEYE n_permits: 94951 last_issue_date: '2026-03-18' windows_measured: null - jurisdiction: CHANDLER n_permits: 94942 last_issue_date: '2026-05-29' windows_measured: null - jurisdiction: PEORIA n_permits: 75435 last_issue_date: '2026-05-07' windows_measured: null - jurisdiction: QUEEN CREEK n_permits: 59103 last_issue_date: '2026-04-24' windows_measured: null - jurisdiction: null n_permits: 43845 last_issue_date: '2026-06-05' windows_measured: null - jurisdiction: PARADISE VALLEY n_permits: 23135 last_issue_date: '2026-04-24' windows_measured: null - jurisdiction: AVONDALE n_permits: 7961 last_issue_date: '2026-04-24' windows_measured: null - jurisdiction: MARICOPA n_permits: 5732 last_issue_date: '2026-12-12' windows_measured: null - jurisdiction: YOUNGTOWN n_permits: 3979 last_issue_date: '2026-06-05' windows_measured: null - jurisdiction: EL MIRAGE n_permits: 1971 last_issue_date: '2026-04-13' windows_measured: null - jurisdiction: YUMA n_permits: 1909 last_issue_date: '2009-01-15' windows_measured: null - jurisdiction: FOUNTAIN HILLS n_permits: 767 last_issue_date: '2026-05-21' windows_measured: null - jurisdiction: ELMIRAGE n_permits: 521 last_issue_date: '2025-08-08' windows_measured: null - jurisdiction: SUN CITY n_permits: 133 last_issue_date: null windows_measured: null - jurisdiction: COCONINO COUNTY n_permits: 63 last_issue_date: '2024-02-16' windows_measured: null - jurisdiction: PINAL COUNTY n_permits: 54 last_issue_date: '2022-07-21' windows_measured: null - jurisdiction: APACHE JUNCTION n_permits: 47 last_issue_date: '2025-05-13' windows_measured: null - jurisdiction: PIMA COUNTY n_permits: 21 last_issue_date: '2016-10-24' windows_measured: null - jurisdiction: WITTMANN n_permits: 8 last_issue_date: '2026-02-03' windows_measured: null - jurisdiction: JACKSON COUNTY n_permits: 7 last_issue_date: null windows_measured: null - jurisdiction: LEWISVILLE n_permits: 5 last_issue_date: '2024-02-07' windows_measured: null - jurisdiction: MONTGOMERY n_permits: 4 last_issue_date: '2023-06-05' windows_measured: null - jurisdiction: RIVERSIDE COUNTY n_permits: 3 last_issue_date: '2026-06-20' windows_measured: null - jurisdiction: LITCHFIELD PARK n_permits: 3 last_issue_date: null windows_measured: null - jurisdiction: APACHE JUNCTION - SEWER UTILITY n_permits: 2 last_issue_date: '2026-05-07' windows_measured: null - jurisdiction: FORT WORTH n_permits: 2 last_issue_date: null windows_measured: null - jurisdiction: YAVAPAI COUNTY n_permits: 1 last_issue_date: null windows_measured: null - jurisdiction: LOCUST GROVE n_permits: 1 last_issue_date: null windows_measured: null - jurisdiction: ORO VALLEY n_permits: 1 last_issue_date: null windows_measured: null - jurisdiction: TANGIPAHOA n_permits: 1 last_issue_date: '2019-05-28' windows_measured: null owner_profile: as_of: '2026-09-09' n_parcels: 1611077 n_multi: 646963 n_portfolio_5: 277841 history: first_week: '2025-07-24' last_week: '2026-09-09' zips: - '85251' n_parcels: 18774 n_events: 236022 n_weeks: 62 domains: tax: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 18597 deed: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 17615 sale: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 1700 listing: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 21122 mailing: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 2128 vacancy: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 2583 financing: first_week: '2025-12-02' last_week: '2026-06-25' n_events: 6420 occupancy: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 1297 ownership: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 3238 structure: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 2548 valuation: first_week: '2025-07-24' last_week: '2026-06-25' n_events: 83657 assessment: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 16450 owner_profile: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 58404 classification: first_week: '2025-07-24' last_week: '2026-09-09' n_events: 263 lenders: as_of: '2026-06-25' recordings_through: '2026-06-11' counties: - '04013' history_capture_share: 0.183706 n_lender_ids: 32045 purchase_measured: true investor_lending_measured: true flips_measured: true borrowers_measured: true takebacks_measured: true counties_measured: false dated: true n_parcels_uncovered: 224192 terms: >- Data: Investorlift Data Services. Public-record and MLS listing data licensed through BatchData; municipal short-term rental registries; Investorlift marketplace records. Attribution and data-use terms: https://developers.investorlift.com/guides/terms headers: ETag: $ref: '#/components/headers/ETag' X-Request-Id: $ref: '#/components/headers/X-Request-Id' X-Rows: $ref: '#/components/headers/X-Rows' X-Dataset-Version: $ref: '#/components/headers/X-Dataset-Version' X-Data-End: $ref: '#/components/headers/X-Data-End' '400': description: >- Bad request (dataset_unavailable, geometry_conflict, geometry_required, invalid_cursor, invalid_id, market_required, quicklist_unavailable, sort_requires_point, unknown_parameter, validation_error) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: geometry_conflict: summary: Geometry conflict value: type: >- https://developers.investorlift.com/guides/concepts/errors#geometry_conflict title: Geometry conflict status: 400 code: geometry_conflict detail: >- You cannot combine radius_miles with bbox. Send one geometry only. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 geometry_required: summary: Geometry required value: type: >- https://developers.investorlift.com/guides/concepts/errors#geometry_required title: Geometry required status: 400 code: geometry_required detail: >- The request needs one geometry: lat and lng with radius_miles, bbox, property_id, zip (a list) or city. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 invalid_cursor: summary: Invalid cursor value: type: >- https://developers.investorlift.com/guides/concepts/errors#invalid_cursor title: Invalid cursor status: 400 code: invalid_cursor detail: >- The API issued the cursor for another query. Restart from page 1. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 invalid_id: summary: Invalid id value: type: >- https://developers.investorlift.com/guides/concepts/errors#invalid_id title: Invalid id status: 400 code: invalid_id detail: >- An investor id is inv_ followed by 12 hex characters. The prefix is part of the id. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 market_required: summary: Market required value: type: >- https://developers.investorlift.com/guides/concepts/errors#market_required title: Market required status: 400 code: market_required detail: >- inv_0a20a550f33b exists in 2 loaded markets. Pass market=. The codes are in markets[]. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 markets: - phx - hou errors: - param: market message: one of phx, hou code: market_required sort_requires_point: summary: Sort requires a reference point value: type: >- https://developers.investorlift.com/guides/concepts/errors#sort_requires_point title: Sort requires a reference point status: 400 code: sort_requires_point detail: >- sort=distance needs a reference point: add lat and lng, or property_id. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 unknown_parameter: summary: Unknown parameter value: type: >- https://developers.investorlift.com/guides/concepts/errors#unknown_parameter title: Unknown parameter status: 400 code: unknown_parameter detail: >- The query carries a parameter this endpoint does not define: kind[]. Write the list as kind=flip,hold or as repeated keys. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 errors: - param: kind[] message: unknown parameter code: unknown_parameter validation_error: summary: Validation error value: type: >- https://developers.investorlift.com/guides/concepts/errors#validation_error title: Validation error status: 400 code: validation_error detail: radius_miles must be 20 or less. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 errors: - param: radius_miles message: must be 20 or less code: too_big headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '401': description: Unauthorized (unauthorized) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: unauthorized: summary: Unauthorized value: type: >- https://developers.investorlift.com/guides/concepts/errors#unauthorized title: Unauthorized status: 401 code: unauthorized detail: 'Send Authorization: Bearer with a current key.' instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '403': description: >- Forbidden (payment_overdue, plan_limit, quota_exceeded, subscription_required) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: plan_limit: summary: Plan limit value: type: >- https://developers.investorlift.com/guides/concepts/errors#plan_limit title: Plan limit status: 403 code: plan_limit detail: >- The free plan searches within 5 miles of a point, a viewport up to 10 miles across, or one ZIP code. Your zip parameter lists 2 ZIP codes. Upgrade in the developer console for city-wide and multi-ZIP searches. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 tier: free limit: geometry max_radius_miles: 5 max_bbox_diagonal_miles: 10 max_zips: 1 quota_exceeded: summary: Quota exceeded value: type: >- https://developers.investorlift.com/guides/concepts/errors#quota_exceeded title: Quota exceeded status: 403 code: quota_exceeded detail: >- Your requests spent the plan's credits for this billing period (5000 of 5000). Wait for the period to reset on the subscription's billing date, or upgrade in the developer console. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 used: 5000 line: 5000 subscription_required: summary: Subscription required value: type: >- https://developers.investorlift.com/guides/concepts/errors#subscription_required title: Subscription required status: 403 code: subscription_required detail: >- This key has no active plan subscription. Subscribe in the developer console. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 payment_overdue: summary: Payment overdue value: type: >- https://developers.investorlift.com/guides/concepts/errors#payment_overdue title: Payment overdue status: 403 code: payment_overdue detail: >- The subscription's payment is overdue and the grace period passed. Update the card under Manage Billing in the developer console. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '406': description: Not acceptable (not_acceptable) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: not_acceptable: summary: Not acceptable value: type: >- https://developers.investorlift.com/guides/concepts/errors#not_acceptable title: Not acceptable status: 406 code: not_acceptable detail: >- Accept text/html names no representation this endpoint produces (application/json). instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '429': description: Rate limited, with Retry-After (rate_limited) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: rate_limited: summary: Rate limited value: type: >- https://developers.investorlift.com/guides/concepts/errors#rate_limited title: Rate limited status: 429 code: rate_limited detail: >- The request exceeded the per-key budget. Retry in 12 seconds. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 retry_after: 12 bucket: key headers: Retry-After: $ref: '#/components/headers/Retry-After' X-Request-Id: $ref: '#/components/headers/X-Request-Id' '500': description: Internal error (internal_error) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: internal_error: summary: Internal error value: type: >- https://developers.investorlift.com/guides/concepts/errors#internal_error title: Internal error status: 500 code: internal_error detail: The request failed. Quote request_id when you report it. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' '503': description: >- Unavailable, with Retry-After on pool_saturated and ledger_unavailable (database_unavailable, ledger_unavailable, pool_saturated) content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: database_unavailable: summary: Database unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#database_unavailable title: Database unavailable status: 503 code: database_unavailable detail: >- The service failed to reach the database and did not run the request. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 ledger_unavailable: summary: Ledger unavailable value: type: >- https://developers.investorlift.com/guides/concepts/errors#ledger_unavailable title: Ledger unavailable status: 503 code: ledger_unavailable detail: >- The credit ledger is unreachable. The API charged nothing. Retry in 5 seconds. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 retry_after: 5 pool_saturated: summary: Pool saturated value: type: >- https://developers.investorlift.com/guides/concepts/errors#pool_saturated title: Pool saturated status: 503 code: pool_saturated detail: >- No pooled connection was free. The service did not run the request. instance: /v1/coverage request_id: 6f1c2a8e-3b7d-4f21-9a0c-2e5b81d7a4f3 headers: Retry-After: $ref: '#/components/headers/Retry-After' X-Request-Id: $ref: '#/components/headers/X-Request-Id' components: schemas: CoverageData: type: object properties: markets: type: array items: $ref: '#/components/schemas/CoverageMarket' description: >- Every loaded market with its matrix. With a place, only the markets that cover it, and [] when none does. place: anyOf: - $ref: '#/components/schemas/CoveragePlace' - type: 'null' description: The place lookup that ran. Null when you gave no place. planned: type: array items: $ref: '#/components/schemas/PlannedMarket' description: >- The markets Investorlift intends to serve and this host does not serve yet, as labelled intent. A code this host has loaded is never listed here. required: - markets - place - planned additionalProperties: false description: >- Which data is available where: the coverage matrix of every loaded market, the place lookup when you asked one, and the planned markets. Meta: type: object properties: generated_at: type: string description: >- When the API produced this response, ISO 8601. It does not change the ETag. weights: description: >- The effective match weights, one per factor, rounded to 4 decimals (buyers/match only). The API rescales the weights of the scored factors to sum 1 before it reports them. type: object propertyNames: type: string additionalProperties: type: number reference_point: description: >- The point the API measures every distance in the response from: lat + lng, or the centre of the property_id parcel. Absent with a bare bbox. type: object properties: lat: type: number minimum: -90 maximum: 90 description: Latitude of the reference point. lng: type: number minimum: -180 maximum: 180 description: Longitude of the reference point. required: - lat - lng additionalProperties: false geometry: $ref: '#/components/schemas/MetaGeometry' description: >- The location that ran, defaults filled and keyed as the query is (see MetaGeometry), on REST only: the MCP meta carries reference_point alone. Present on every route that takes a location: the deal lists, summary and cells, the investors, wholesale listings and short-term rental parcels, and `/v1/buyers/match`. Also on the comps of a parcel, kind radius around the subject and property_id the subject, and on POST `/v1/properties/search` (a county-only body echoes nothing). The lender list and a lender's loans carry it when you gave a geometry, a zip or a city. They apply a geometry as the H3 res-8 cells whose centre lies inside it, and echo no county, because MetaGeometry has no county slot. Absent on a route with no location, and on `/v1/properties/resolve`, whose lat + lng is a hint for the nearest parcel, not an area that ran. resolved_from: description: >- Present when an id in the request was an old id from an earlier data refresh: the old ids the API followed, in order. The ids are the investor id, from the path or the investor_id filter, the agent id and the lender id. The lender id comes from the path of the lender routes, the financed_by filter or filters.financing.lender_id. Store the id the response carries, not the old one. type: array items: type: string pattern: ^(inv|agt|len)_[0-9a-f]{12}$ description: >- An investor id (inv_...), a listing agent id (agt_...) or a lender id (len_...). coverage: type: array items: $ref: '#/components/schemas/Coverage' description: >- The markets the response draws on, with their counties, data end dates and data versions. dated: description: >- Present when the response carries a block that is a dated snapshot at its as-of date, not current data. Those blocks are the financing, lien and valuation blocks of the parcel products. One entry per dated block, with its as-of date. Absent when nothing in the response is dated. type: array items: $ref: '#/components/schemas/Dated' terms: type: string description: Attribution and data-use terms for the data in this response. required: - generated_at - coverage - terms additionalProperties: false description: >- Response metadata: when the API produced it, which markets it covers, and how fresh they are. Problem: type: object properties: type: type: string description: >- URI of the problem: the Errors page of the documentation site, anchored at the code. title: type: string description: Short human-readable summary of the problem code. status: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: HTTP status. code: type: string description: >- Stable machine-readable code from the catalogue at https://developers.investorlift.com/problems.json. detail: type: string description: Human-readable explanation specific to this occurrence. instance: type: string description: Request path. request_id: type: string description: Request id to quote when you report a problem. errors: description: Per-parameter validation failures (400 only). type: array items: type: object properties: param: description: >- The offending parameter. Null when the problem is not about one parameter. type: - string - 'null' message: type: string description: What is wrong with it. code: type: string description: Machine-readable reason, for example invalid_enum_value. required: - param - message - code additionalProperties: false description: One validation failure. required: - type - title - status - code - detail - instance - request_id additionalProperties: {} description: >- RFC 9457 problem details (application/problem+json). Some codes add extra fields beside these: superseded_by, candidates, n_deals, cap, suggestion, markets, retry_after. CoverageMarket: type: object properties: market: type: string minLength: 1 maxLength: 16 description: Market code; the loaded markets are in meta.coverage[]. state: type: string description: >- 2-letter state of the market. The loaded markets and their states are in meta.coverage[]. label: type: string description: >- The display name of the market, for example "Phoenix metro". The county names and the state where none is set. stage: type: string enum: - general - beta description: general, or beta while the pricing pages label the market so. universe_kind: anyOf: - type: string enum: - zip - county - metro description: >- The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. - type: 'null' description: >- Null when the market row does not record it. The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. universe_zips: anyOf: - type: array items: type: string description: A 5-digit ZIP. - type: 'null' description: The ZIP codes of a zip universe; null for county and metro markets. counties: type: array items: type: object properties: fips: type: string description: The 5-digit county FIPS code, for example 04013. name: type: string description: County name, for example Maricopa. data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The last deed date on file for this county, YYYY-MM-DD. Null when the county carries no dated deed. required: - fips - name - data_end additionalProperties: false description: One county the loaded area lies in. description: >- The counties the loaded area lies in, each with its own last deed date. bbox: type: array prefixItems: - type: number minimum: -180 maximum: 180 description: West edge (longitude). - type: number minimum: -90 maximum: 90 description: South edge (latitude). - type: number minimum: -180 maximum: 180 description: East edge (longitude). - type: number minimum: -90 maximum: 90 description: North edge (latitude). items: false minItems: 4 maxItems: 4 description: >- The rectangle (west, south, east, north) that encloses every deal in the market. point_tolerance_miles: type: number description: >- How far outside bbox a point can lie and still get an answer, in miles. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels in the loaded area; null when not recorded. data_end: type: string description: The last deed date in the market, YYYY-MM-DD. dataset_version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Version of the loaded data for this market; the same value meta.coverage[].dataset_version carries. loaded_at: type: string description: When this data version went live, ISO 8601. stale: type: boolean description: >- True when data_end is more than 45 days before the time of the request. datasets: type: object properties: deeds: $ref: '#/components/schemas/DatasetCoverage' listings: $ref: '#/components/schemas/DatasetCoverage' agents: $ref: '#/components/schemas/DatasetCoverage' wholesale: $ref: '#/components/schemas/DatasetCoverage' auction: $ref: '#/components/schemas/DatasetCoverage' str: $ref: '#/components/schemas/DatasetCoverage' parcels: $ref: '#/components/schemas/DatasetCoverage' financing: $ref: '#/components/schemas/DatasetCoverage' permits: $ref: '#/components/schemas/DatasetCoverage' owner_profile: $ref: '#/components/schemas/DatasetCoverage' history: $ref: '#/components/schemas/DatasetCoverage' cash_sale: $ref: '#/components/schemas/DatasetCoverage' lenders: $ref: '#/components/schemas/DatasetCoverage' addresses: $ref: '#/components/schemas/DatasetCoverage' required: - deeds - listings - agents - wholesale - auction - str - parcels - financing - permits - owner_profile - history - cash_sale - lenders - addresses additionalProperties: false description: >- The matrix row of this market: one cell per dataset key, in the order of the keys. required: - market - state - label - stage - universe_kind - universe_zips - counties - bbox - point_tolerance_miles - n_parcels - data_end - dataset_version - loaded_at - stale - datasets additionalProperties: false description: >- One loaded market with its coverage matrix: the area, the version, the freshness, and one cell per dataset with its status there. CoveragePlace: type: object properties: input: type: object properties: kind: type: string enum: - point - county - zip - market description: 'The lookup that ran: point (lat and lng), county, zip or market.' value: type: string description: >- The value the API resolved: "lat,lng", the county as you gave it, the ZIP, or the market code. required: - kind - value additionalProperties: false description: The place that was asked about. status: type: string enum: - covered - outside description: >- covered when at least one loaded market admits the place. outside when none does. Never a 422: this route answers the question the data routes refuse. markets: type: array items: type: string minLength: 1 maxLength: 16 description: >- The market codes that cover the place, in load order. [] when outside. counties: anyOf: - type: array items: type: object properties: fips: type: string description: 5-digit county FIPS. name: type: string description: County name. required: - fips - name additionalProperties: false - type: 'null' description: >- The counties the input resolved to, by ascending FIPS. A county name that two served states share gives one county per state, so read the FIPS, not the first row. A ZIP input gives every county the ZIP touches, largest land share first, through the public ZIP-to-county crosswalk. Null for a point or a market code. required: - input - status - markets - counties additionalProperties: false description: >- The place lookup: the place you asked about, if a loaded market covers it, which markets, and the counties it resolved to. PlannedMarket: type: object properties: market: type: string minLength: 1 maxLength: 16 description: The code the market will load under. label: type: string description: The market's display name. state: type: string description: >- 2-letter state of the market. The loaded markets and their states are in meta.coverage[]. counties: type: array items: type: object properties: fips: type: string description: 5-digit county FIPS. name: type: string description: County name. required: - fips - name additionalProperties: false description: The counties the build intends to load. datasets: type: array items: type: string enum: - deeds - listings - agents - wholesale - auction - str - parcels - financing - permits - owner_profile - history - cash_sale - lenders - addresses description: >- A dataset a market can lack. The keys are deeds, listings, agents, wholesale, auction, str, parcels, financing, permits, owner_profile, history, cash_sale, lenders and addresses. Deeds carries the deals, the investors and the registry, and listings the MLS listings. Agents carries the listing agents, wholesale the Investorlift listings, and auction the foreclosure-auction and REO counts. Str carries the short-term rental rolls, and parcels the parcel layer and the property search. Financing carries the dated financing, lien and valuation slice, and history the weekly history lake. Cash_sale carries the cash-sale proxy, lenders the lender registry, and addresses the lookup by street address. description: The datasets the build intends to serve. status: type: string enum: - planned - building description: >- planned: decided, not started. building: the chain runs on a build database, and the production publish is a separate step. since: type: string description: The day the row was listed, YYYY-MM-DD. target: description: A quarter such as 2027-Q1 when one is decided; null otherwise. type: - string - 'null' label_kind: type: string const: intent description: >- Always "intent": a planned row is intent, not a commitment. The Developer Agreement promises no refresh cadence and no continuity, and the list can change without notice. note: description: One sentence of context, or null. type: - string - 'null' required: - market - label - state - counties - datasets - status - since - target - label_kind - note additionalProperties: false description: >- A market Investorlift intends to serve and this host does not serve yet, as labelled intent. It leaves this list the day its tables are published, and appears in markets[] instead. MetaGeometry: type: object properties: kind: type: string enum: - radius - bbox - place description: >- Which location ran: radius, bbox or place. A radius is a point with radius_miles, or a property_id request, which runs around the parcel centroid. A bbox is a viewport. A place is a ZIP list or a postal city. lat: anyOf: - type: number minimum: -90 maximum: 90 description: WGS84 latitude. - type: 'null' description: >- The centre of the radius, or the reference point you gave beside a bbox or a place. For a property_id request the centre is the parcel centroid. Null when a bbox or a place had no reference point. lng: anyOf: - type: number minimum: -180 maximum: 180 description: WGS84 longitude. - type: 'null' description: The longitude beside lat. Null when lat is null. radius_miles: description: >- The radius that ran, in miles: the value you sent, or the default when you sent none. The default is 2 on the GET lists and 1 around property_id on POST `/v1/properties/search`. Null for a bbox or a place. type: - number - 'null' bbox: anyOf: - type: array prefixItems: - type: number minimum: -180 maximum: 180 description: West edge (longitude). - type: number minimum: -90 maximum: 90 description: South edge (latitude). - type: number minimum: -180 maximum: 180 description: East edge (longitude). - type: number minimum: -90 maximum: 90 description: North edge (latitude). items: false minItems: 4 maxItems: 4 description: '[west, south, east, north] in WGS84 degrees.' - type: 'null' description: >- The viewport as [west, south, east, north] in WGS84 degrees. Null unless kind is bbox. property_id: anyOf: - type: string pattern: ^prop_[0-9a-f]{32}$ description: >- Parcel id: prop_ followed by 32 hex characters, for example prop_e93c776c53354a88de4e58448a6bf21b. The prefix is part of the id. - type: 'null' description: >- The parcel at the centre of the radius. Null unless the request named property_id. zip: anyOf: - type: array items: type: string pattern: ^\d{5}$ - type: 'null' description: >- The ZIP list as you sent it, for example ["85251", "85257"]. Null unless kind is place and the request named ZIPs. city: description: >- The postal city as the API compared it: trimmed and folded to upper case ("Scottsdale" ran as "SCOTTSDALE"). Null unless kind is place and the request named a city. type: - string - 'null' required: - kind - lat - lng - radius_miles - bbox - property_id - zip - city additionalProperties: false description: >- The location the API computed the response over, as it ran: defaults filled, a parcel resolved to its centroid, a city folded. Copy it back as the query to repeat the request. Coverage: type: object properties: market: type: string description: Market code, for example phx. One entry per loaded market. state: type: string description: >- 2-letter state of the market. The loaded markets and their states are in meta.coverage[]. counties: type: array items: type: object properties: fips: type: string description: The 5-digit county FIPS code, for example 04013. name: type: string description: County name, for example Maricopa. data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The last deed date on file for this county, YYYY-MM-DD. Null when the county carries no dated deed. required: - fips - name - data_end additionalProperties: false description: One county the loaded area lies in. description: >- The counties the loaded area lies in, each with its own data end date. For a zip market the list names the county, but the loaded area is only the ZIP (see universe_kind). bbox: type: array prefixItems: - type: number minimum: -180 maximum: 180 description: West edge (longitude). - type: number minimum: -90 maximum: 90 description: South edge (latitude). - type: number minimum: -180 maximum: 180 description: East edge (longitude). - type: number minimum: -90 maximum: 90 description: North edge (latitude). items: false minItems: 4 maxItems: 4 description: >- The rectangle (west, south, east, north) that encloses every deal in the market: the initial map viewport and, with point_tolerance_miles, the limit for outside_coverage. data_end: type: string description: >- The last deed date in the data, YYYY-MM-DD. The API measures every "days since" value from this data_end, never from the request time. build_run_id: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Which pipeline build produced the data. Informational: use dataset_version for caching. Null when the data does not record it. registry_run: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Which investor registry run produced the data. Informational: use dataset_version for caching. Null when the data does not record it. registry_version: description: >- Which registry code version produced the data. Informational: use dataset_version for caching. Null when the data does not record it. type: - string - 'null' dataset_version: type: integer minimum: -9007199254740991 maximum: 9007199254740991 description: >- Version of the loaded data, an integer that grows with every refresh. It is the cache key and the ETag, and every cursor binds to it. loaded_at: type: string description: When this data version went live, ISO 8601. metro_buy_to_resale_ratio: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The median of purchase price divided by resale price over the market's priced flips since 2021. For example, 0.72 means flippers pay about 72% of the resale price. The price_fit factor uses it when an investor has too few flips of their own. Null when no priced flips exist. universe_kind: anyOf: - type: string enum: - zip - county - metro description: >- The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. - type: 'null' description: >- Null when the market row does not record it, a seed older than the column. The area every count in this market covers: metro, county or zip. A metro market covers whole counties. A county market covers one county. The market cannot see what an investor did in the neighbouring counties. A zip market covers one or more ZIP codes. The market cannot see what an investor did outside them, a larger gap. In a county or zip market every investor count, price band, scale tier and confidence is a floor. universe_zips: anyOf: - type: array items: type: string description: A 5-digit ZIP. - type: 'null' description: >- The ZIP codes of a zip universe, for example ["77088"]. Null for county and metro markets. point_tolerance_miles: type: number description: >- How far outside bbox a point can lie and get an answer, in miles: 20 for a metro, 2 for a county market. The point is lat + lng, or the centre of a property_id parcel. Farther out, the API answers 422 outside_coverage. A bbox must intersect the coverage bbox. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels in the loaded area, the universe every count covers. Null when the data does not record it. listings_data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The as-of date of the MLS listing feed for this market, YYYY-MM-DD: the newest status update among its listing rows, later than data_end. The deeds and the listings arrive in one delivery, each with its own end. The API measures every listing window (days_on_market, n_listed_12m) against this date. Null when this market has no published listing tables. Every listing block and listings rollup is null then, and the correct reading is "no listing data". agents_data_end: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The as-of date of the listing set behind the agent registry of this market, YYYY-MM-DD. It equals listings_data_end when the registry is current. It is earlier when a refresh moved the listings but left the agents on the older set. Null when this market has no published agent tables. Then every agent_id, identity_basis and agent_is_holder_member on the listing agents is null, and the investor profile carries has_licensed_member and agent_links null. The /v1/agents routes then answer 422 agents_unavailable. wholesale_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the Investorlift export behind the market's wholesale transactions, YYYY-MM-DD. Every Investorlift listing published up to this date is on file. The API measures every wholesale window (n_listed_12m, n_bought_via_investorlift_12m) against the deed data_end. Null when this market has no published wholesale tables. Then every wholesale_listing block on deal rows, wholesale_purchases block on investor rows and wholesale_listings[] on a parcel is null. Then /v1/wholesale-listings, /v1/wholesalers, `/v1/investors/{id}/wholesale-purchases` and the source=investorlift and bought_on_investorlift filters answer 422 wholesale_unavailable. str_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The short-term rental snapshot of this market, YYYY-MM-DD: the oldest snapshot date among its served jurisdictions. Each jurisdiction's own date is in str.jurisdictions[].snapshot_date and on every block as data_as_of. Null when this market has no published short-term rental tables, or when the API serves none of its jurisdictions. Then every short_term_rental block on parcels and hold rows and every str roll-up on investor rows is null. Then the str_status, str_business_use, str_operator and str_holdings_min filters and /v1/str-parcels answer 422 str_unavailable. str: anyOf: - type: object properties: jurisdictions: type: array items: $ref: '#/components/schemas/StrCoverageJurisdiction' description: >- Every city of the market the short-term rental build knows, served or not. This list, not the parcel, explains a null block on a parcel: read the city's coverage_reason. required: - jurisdictions additionalProperties: false - type: 'null' description: >- The short-term rental jurisdiction table of this market. Null when this market has no published short-term rental tables. auction_counted: type: boolean description: >- True when this market measures the foreclosure-auction and REO purchase counts. Then every investor row carries the auction block (investor.auction) and deal rows carry bought_auction_kind. False when the market's registry build came before the counts existed. Then the block is null on every investor of the market, and bought_auction_kind is null on every deal. The buys_at_auction, buys_reo and bought_auction_kind filters then answer 422 auction_unavailable. parcel_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The deed data end that the build of the parcel product layer used, YYYY-MM-DD. The layer serves POST /v1/properties/search and the financing, permit and history routes. Null when this market has no published parcel product tables: those routes then answer 422 parcels_unavailable. address_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The deed data end of the address table behind GET /v1/properties/resolve?address, YYYY-MM-DD. Null when this market has no published address table. The address lookup answers 422 addresses_unavailable while no market carries the table. parcel: anyOf: - $ref: '#/components/schemas/ParcelCoverage' - type: 'null' description: >- What the parcel products cover in this market. The parts are the layer, the dated financing slice, the permit snapshot, the Owner Profile block and the history lake with its ZIP set. Null when this market has no published parcel product tables. lenders: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The slice date behind the lender registry, YYYY-MM-DD. It equals parcel.financing.as_of. recordings_through: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The newest recording date in either source table, YYYY-MM-DD. The API measures every recency on a lender against this date. counties: type: array items: type: string description: A 5-digit county FIPS. description: >- The counties the lender registry covers. A ZIP, city or county outside them answers 422 outside_coverage. history_capture_share: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of open lien positions recorded since 2022 that the recorded history also carries within 3 days, 0 to 1. It says how much of the open table the history sees. n_lender_ids: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Lender ids served in the market: the identities with a profile, after the person gate. parcel.financing.n_lenders counts raw spellings, several per id. purchase_measured: type: boolean description: >- True when the market has the deed link. Then the API serves purpose and the deed block on the loan rows, and the purchase-money counts and ranks on the lenders. It also serves the lender list's purpose, investor_only and purchase_desc parameters. False on a registry built before the deed link: every such value is null, and those parameters answer 422 lenders_unavailable. investor_lending_measured: type: boolean description: >- True when the market has the deal link and the borrower match. Then the API serves the deal block, outcome and investor ids on the loan rows, and the investor_lending block on the profiles. It also serves the financing block on deal rows and the financing sidecar on investor profiles. False otherwise: every one of those is null. flips_measured: type: boolean description: >- True when the market measures the flips each lender financed, the flips_financed block on the profiles. False otherwise: the block is null. borrowers_measured: type: boolean description: >- True when the market has the borrower fold. Then the API serves borrower keys on the loan rows, the borrowers block on the profiles, GET `/v1/lenders/{id}/borrowers` and the financed_by and uses_private_lender filters. False otherwise: the block is null, and the route and the filters answer 422 lenders_unavailable. takebacks_measured: type: boolean description: >- True when the registry of this market includes the foreclosure take-backs. That needs the auction deed tables built and the lender members present. Then the API serves the takebacks block on the profiles, the foreclosed block on the loan rows and the FORECLOSED outcome. False otherwise: the block is null on every profile, and foreclosed is null on every loan row. counties_measured: type: boolean description: >- True when the market has more than one loaded county, so a county ranking means something: rankings.n_counties_ranked_first_24m on the profiles. False while the slice covers one county: that count is null. dated: description: >- True when the registry is a snapshot valued at as_of, like the financing slice behind it. The API stamps every value from it in meta.dated[] as the lenders block. Null on a registry row that does not record it, a row older than the column. type: - boolean - 'null' n_parcels_uncovered: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels of the market outside the counties the registry covers. Such a county is one the financing slice does not reach. Null when the row does not record it. required: - as_of - recordings_through - counties - history_capture_share - n_lender_ids - purchase_measured - investor_lending_measured - flips_measured - borrowers_measured - takebacks_measured - counties_measured - dated - n_parcels_uncovered additionalProperties: false - type: 'null' description: >- The lender registry of this market. Null when this market has no published lender tables: every /v1/lenders route then answers 422 lenders_unavailable. required: - market - state - counties - bbox - data_end - build_run_id - registry_run - registry_version - dataset_version - loaded_at - metro_buy_to_resale_ratio - universe_kind - universe_zips - point_tolerance_miles - n_parcels - listings_data_end - agents_data_end - wholesale_as_of - str_as_of - str - auction_counted - parcel_as_of - address_as_of - parcel - lenders additionalProperties: false description: >- One loaded market: the area its counts cover (universe_kind), the counties it lies in, how fresh it is, and its data version. Dated: type: object properties: block: type: string enum: - valuation - financing - liens - lenders description: >- The block of the response that is a snapshot at as_of, not current data. The values are valuation (the AVM, equity and LTV), financing (open liens and mortgage history), liens (involuntary liens) and lenders. The lenders block is the lender registry and every count on it, built from the same slice. as_of: type: string description: >- The date of the delivery that valued the snapshot, YYYY-MM-DD: the same date as meta.coverage[].parcel.financing.as_of for the market. reason: type: string description: >- Why the block is dated, in one sentence: the dataset is not in the current delivery. required: - block - as_of - reason additionalProperties: false description: >- One block of the response that is a dated snapshot. Every response that carries a value from a dated block lists it here. A caller that cannot use dated data passes require_current: true. The API then answers 422 dated_refused instead. DatasetCoverage: type: object properties: status: type: string enum: - served - partial - not_measured - not_published description: >- The dataset's status for the market. Served: the API publishes the dataset for the whole market, or for every item of its scope it can serve. Partial: the API serves at least one item of the scope and not every item it can serve. Not_measured: the build ran and the delivery cannot measure the fact. No build fixes it, so do not wait. Not_published: the tables are absent or unbuilt for the market. A later build fixes it, so wait. Not_applicable: a scope item the API can never serve, for example a city with no licence requirement. It is never the status of a whole dataset. dated: type: boolean description: >- True when the dataset is a snapshot valued at as_of and every response that carries a value from it stamps meta.dated[]. The financing slice is dated, and so is the lender registry built from it. Independent of status: a dataset can be partial and dated at once. A dated set never refreshes. With require_current it answers 422 dated_refused. stale: description: >- True when the as-of date failed its freshness rule against the clock of the request. Deeds follow the 45-day rule, and short-term rentals the weekly feed rule of a served jurisdiction. Null where no rule exists: listings, agents, wholesale, parcels and lenders. A dated set never refreshes, and a stale one is late. type: - boolean - 'null' as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The dataset's date, one per dataset. Deeds carry the last deed date, listings the end of the listing feed, and wholesale the Investorlift export date. Short-term rentals carry the snapshot date, parcels the deed end of the layer, and financing the slice date. Permits carry the snapshot date, owner_profile the delivery date, history the last week of the lake, and lenders the slice date. Null where the API does not publish the dataset. Also null for the auction counts, which carry no date of their own. gate: anyOf: - type: string enum: - outside_coverage - listings_unavailable - agents_unavailable - wholesale_unavailable - auction_unavailable - str_unavailable - parcels_unavailable - history_unavailable - cash_sale_unavailable - lenders_unavailable - addresses_unavailable - dated_refused - type: 'null' description: >- For not_published and not_measured, the error code a data call meets when it needs the dataset. The codes are listings_unavailable, agents_unavailable, wholesale_unavailable, auction_unavailable, str_unavailable, parcels_unavailable, history_unavailable, cash_sale_unavailable, lenders_unavailable and addresses_unavailable. Null for served and partial. Each scope item then carries its own code. granularity: type: string enum: - market - county - jurisdiction - zip description: >- The grain of the dataset. Deeds and lenders are decided at county grain. Short-term rentals and permits are decided at jurisdiction grain. The history lake is decided at zip grain. Every other dataset is decided at market grain. scope: anyOf: - type: object properties: kind: type: string enum: - counties - jurisdictions - zips description: counties, jurisdictions or zips. items: type: array items: $ref: '#/components/schemas/CoverageScopeItem' description: Every item, served or not. required: - kind - items additionalProperties: false - type: 'null' description: >- The list of items at the grain of the dataset, with a status per item. Deeds lists the counties of the market with their deed ends. Lenders lists every county of the market and the registry's cover. Short-term rentals lists every jurisdiction, permits every issuer, and history every ZIP the lake covers. Null for a market-grain dataset, and null where the API publishes nothing. features: anyOf: - type: object propertyNames: type: string additionalProperties: type: boolean - type: 'null' description: >- Lenders only: the per-market *_measured flags of the registry: purchase_measured, investor_lending_measured, flips_measured, borrowers_measured, takebacks_measured and counties_measured. They are features of one dataset, not statuses. Null elsewhere. place_status: description: >- Present only when you gave a place: what this place gets from this dataset at the grain of the dataset. served or outside. Null when the input cannot decide the grain. A bare point decides neither the lender registry nor a jurisdiction. A ZIP and a county decide no jurisdiction. anyOf: - type: string enum: - served - outside - type: 'null' required: - status - dated - stale - as_of - gate - granularity - scope - features additionalProperties: false description: >- One dataset of one market: its status, its dated and stale flags and its as-of date. It also carries the error a call meets where the API does not serve it, and its scope. StrCoverageJurisdiction: type: object properties: name: type: string description: >- The jurisdiction, upper case, for example SCOTTSDALE, PHOENIX or HOUSTON: the city-limit polygon the parcel falls in, never the postal city. The same value as short_term_rental.coverage.jurisdiction on the parcels inside it. regime: anyOf: - type: string enum: - REQUIRED - NOT_REQUIRED - UNKNOWN description: >- The city's rule on a short-term rental licence or permit. REQUIRED: an ordinance requires one. NOT_REQUIRED: the city has no requirement, so no roll exists. UNKNOWN: the survey did not cover the city. Null when the market row does not record it. - type: 'null' description: >- Null when the market row does not record it. The city's rule on a short-term rental licence or permit. REQUIRED: an ordinance requires one. NOT_REQUIRED: the city has no requirement, so no roll exists. UNKNOWN: the survey did not cover the city. Null when the market row does not record it. coverage_reason: anyOf: - type: string enum: - LOADED_SERVED - LOADED_UNVALIDATED - LOADED_COUNTS_ONLY - REQUIRED_NOT_PUBLISHED - NO_REQUIREMENT - NOT_SURVEYED description: >- Why parcels of this jurisdiction carry, or do not carry, a short-term rental block. LOADED_SERVED: the city's roll is on file, matched to parcels and served, so every parcel inside carries a block, NONE when it has no record. LOADED_UNVALIDATED: the roll is on file and matched, but without a spot check, so the block is present with status null and coverage.served false. LOADED_COUNTS_ONLY: the roll is on file for counts only, because no parcel match is possible for the file, so no block. No block for REQUIRED_NOT_PUBLISHED (licence required, no roll published), NO_REQUIREMENT (no licence required) or NOT_SURVEYED (outside the survey). Null when the market row does not record it. - type: 'null' description: >- Null when the market row does not record it. Why parcels of this jurisdiction carry, or do not carry, a short-term rental block. LOADED_SERVED: the city's roll is on file, matched to parcels and served, so every parcel inside carries a block, NONE when it has no record. LOADED_UNVALIDATED: the roll is on file and matched, but without a spot check, so the block is present with status null and coverage.served false. LOADED_COUNTS_ONLY: the roll is on file for counts only, because no parcel match is possible for the file, so no block. No block for REQUIRED_NOT_PUBLISHED (licence required, no roll published), NO_REQUIREMENT (no licence required) or NOT_SURVEYED (outside the survey). Null when the market row does not record it. served: type: boolean description: >- True when parcels inside this jurisdiction carry a measured status (LICENSED, PENDING, EXPIRED or NONE). False when they carry a block with status null, or no block at all: coverage_reason says why. snapshot_only: type: boolean description: >- True when the roll came from a single pull and has no weekly feed (Fountain Hills, Cave Creek). Its dates are the pull date, and the API never sets feed_stale. licence_start: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The earliest possible date of a licence in this jurisdiction, the day its ordinance took effect, YYYY-MM-DD, for example 2025-10-01 for Houston. Null when unknown, or when the city requires no licence. snapshot_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The snapshot the served blocks read, YYYY-MM-DD: short_term_rental.data_as_of on every parcel inside. Null when no roll is on file. feed_stale: type: boolean description: >- True when this week's feed failed the freshness rule and the API serves the last good snapshot instead. Every block inside then carries coverage.feed_stale true. False otherwise. sources: type: array items: $ref: '#/components/schemas/StrCoverageSource' description: >- The city files behind this jurisdiction, each with its newest load date and its stale flag. Empty when no roll is on file. n_licensed: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels inside with status LICENSED on this snapshot. Null when no roll is on file. n_pending: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels inside with status PENDING. Null when no roll is on file. n_expired: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels inside with status EXPIRED. Null when no roll is on file. n_advertised: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Parcels the city lists as advertised without a licence, Scottsdale only. The API counts them and never serves them as a status. Null when the city publishes no such list. share_unmatched: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of the city's records that matched no parcel, 0 to 1, for example 0.04. Null when no roll is on file. share_assumed: anyOf: - type: number description: Decimal ratio, never a percentage (0.53 = +53%). - type: 'null' description: >- The share of attributed parcels with attribution_basis ASSUMED, 0 to 1. ASSUMED means the attribution has no date, no name and no regime bound. Null when no roll is on file. required: - name - regime - coverage_reason - served - snapshot_only - licence_start - snapshot_date - feed_stale - sources - n_licensed - n_pending - n_expired - n_advertised - share_unmatched - share_assumed additionalProperties: false description: >- One city of the market in the short-term rental build. It says if the licence roll is on file and served, how fresh it is, and what it counts. It explains a null short_term_rental block on a parcel: the block is null where the API does not serve the jurisdiction. ParcelCoverage: type: object properties: parcel_as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: The deed data end that the parcel layer build used, YYYY-MM-DD. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels in the layer for this market. sale_mortgage_measured: type: boolean description: >- True when the delivery records a purchase mortgage on at least one priced last sale in five of the market. Then cash_sale_proxy, the sale.cash_sale filter and the cash-buyer quicklist are measured. False below that bar, as in the 2026 deliveries, which carry the column empty. Then cash_sale_proxy is null on every parcel, and the filter and the quicklist answer 422 cash_sale_unavailable. financing: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the delivery that valued the financing, lien and valuation slice, YYYY-MM-DD. dated: type: boolean description: >- True while the Recorder & Mortgage and AVM datasets are not in the current delivery, so the slice stays at as_of. The API then stamps every value from the slice in meta.dated[]. dated_reason: description: Why the slice is dated. type: - string - 'null' n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with a row in the slice. n_with_open_lien: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with at least one open lien at as_of. n_free_and_clear: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with zero open liens at as_of. n_avm: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with an AVM at as_of. n_involuntary: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with an involuntary lien at as_of. n_lenders: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Distinct raw lender spellings over the two lien tables, not registry ids. For registry ids, read meta.coverage[].lenders.n_lender_ids. required: - as_of - dated - dated_reason - n_parcels - n_with_open_lien - n_free_and_clear - n_avm - n_involuntary - n_lenders additionalProperties: false - type: 'null' description: The financing slice. Null when this market has none. permits: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The effective date of the loaded permit snapshot, YYYY-MM-DD. n_permits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Permits served for this market. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels with at least one permit. n_unmatched: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: >- Permits in the county file that landed on no parcel of the market, so the API does not serve them. jurisdictions: anyOf: - type: array items: type: object properties: jurisdiction: type: - string - 'null' n_permits: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' last_issue_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' windows_measured: description: >- True when the jurisdiction issued a permit in the 12 months before as_of. False when it did not: its feed is stale, so its parcels carry null 24-month and 36-month windows. The rule applies in every market. Read those null windows (n_permits_24m, n_open_permits_12m, major_work_36m, tags_24m, job_value_24m) as unmeasured, not as permit-free. The negative permit filters of the search leave such parcels out. Null only on a coverage row built before the flag existed. type: - boolean - 'null' required: - jurisdiction - n_permits - last_issue_date - windows_measured additionalProperties: false - type: 'null' description: >- The issuing jurisdictions, largest first, each with its permit count, its newest issue date and its windows_measured flag. required: - as_of - n_permits - n_parcels - n_unmatched - jurisdictions additionalProperties: false - type: 'null' description: The permit snapshot. Null when this market has none. owner_profile: anyOf: - type: object properties: as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the delivery the Owner Profile block comes from, YYYY-MM-DD. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels carrying a profile. n_multi: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels whose owner holds two or more properties. n_portfolio_5: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels whose owner holds five or more. required: - as_of - n_parcels - n_multi - n_portfolio_5 additionalProperties: false - type: 'null' description: The Owner Profile block. Null when this market has none. history: anyOf: - type: object properties: first_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The first weekly file the history lake replayed (the baseline FULL). last_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: The last weekly file replayed. zips: anyOf: - type: array items: type: string - type: 'null' description: >- The ZIP codes the history lake covers. A parcel outside them has no history: `GET /v1/properties/{id}/history` answers 422 history_unavailable and the history block is null. n_parcels: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Parcels observed in the ZIP set. n_events: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Typed events on record. n_weeks: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' description: Weekly files replayed. domains: anyOf: - type: object propertyNames: type: string additionalProperties: type: object properties: first_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' last_week: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' n_events: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - first_week - last_week - n_events additionalProperties: false - type: 'null' description: >- Per domain, the weeks the lake covers it. Valuation and financing end at the financing slice date, financing.as_of. The rest run to last_week. required: - first_week - last_week - zips - n_parcels - n_events - n_weeks - domains additionalProperties: false - type: 'null' description: The history lake. Null when this market has none. required: - parcel_as_of - n_parcels - sale_mortgage_measured - financing - permits - owner_profile - history additionalProperties: false description: >- What the parcel products cover in one market. The parts are the parcel layer, the dated financing slice, the permit snapshot, the Owner Profile block and the history lake. Each carries its as-of date and counts. CoverageScopeItem: type: object properties: key: type: string description: >- The item's key at the dataset's grain: a 5-digit county FIPS, an upper-case jurisdiction or permit issuer name, or a 5-digit ZIP. A blank issuer is the empty string. name: description: The county name for a county item; null for a jurisdiction or a ZIP. type: - string - 'null' status: type: string enum: - served - partial - not_measured - not_published - not_applicable description: >- The item's own status. Served: the API publishes the dataset for the whole market, or for every item of its scope it can serve. Partial: the API serves at least one item of the scope and not every item it can serve. Not_measured: the build ran and the delivery cannot measure the fact. No build fixes it, so do not wait. Not_published: the tables are absent or unbuilt for the market. A later build fixes it, so wait. Not_applicable: a scope item the API can never serve, for example a city with no licence requirement. It is never the status of a whole dataset. gate: anyOf: - type: string enum: - outside_coverage - listings_unavailable - agents_unavailable - wholesale_unavailable - auction_unavailable - str_unavailable - parcels_unavailable - history_unavailable - cash_sale_unavailable - lenders_unavailable - addresses_unavailable - dated_refused - type: 'null' description: >- The error code a data call meets for this item alone. A county outside the lender registry reads outside_coverage. A ZIP outside the lake reads history_unavailable. Null where the API serves the item. Also null for an unserved short-term rental jurisdiction, because the filters answer an empty page there, not an error. as_of: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The item's own date: a county's last deed date, a jurisdiction's snapshot date, or a permit issuer's newest issue date. Null where nothing is loaded. reason: description: >- For a short-term rental jurisdiction, its coverage_reason: LOADED_SERVED, LOADED_UNVALIDATED, LOADED_COUNTS_ONLY, REQUIRED_NOT_PUBLISHED, NO_REQUIREMENT or NOT_SURVEYED. Null elsewhere. type: - string - 'null' regime: description: >- For a short-term rental jurisdiction, if it requires a licence: REQUIRED, NOT_REQUIRED or UNKNOWN. Null elsewhere. type: - string - 'null' feed_stale: description: >- For a short-term rental jurisdiction, true when this week's feed failed its freshness rule and the API serves the last good snapshot. Null elsewhere. type: - boolean - 'null' licence_start: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- For a short-term rental jurisdiction, the earliest date a licence can exist there. Null elsewhere, and null when unknown. counts: anyOf: - type: object propertyNames: type: string additionalProperties: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' - type: 'null' description: >- The counts the source row records for the item. A jurisdiction carries n_licensed, n_pending, n_expired and n_advertised. A permit issuer carries n_permits. Null for a county and for a ZIP. A count itself is null where the jurisdiction is not loaded, because a missing measurement is not a zero. required: - key - name - status - gate - as_of - reason - regime - feed_stale - licence_start - counts additionalProperties: false description: >- One item of a dataset's scope, at the grain of the dataset: a county, a city-limit jurisdiction, a permit issuer or a ZIP. Each item carries its own status, gate and date. StrCoverageSource: type: object properties: source: type: string description: >- The source code of one city file, for example S1 (the Scottsdale licensed roll), P1 (the Phoenix active permits layer) or COH (the Houston registry). snapshot_date: anyOf: - type: string description: Calendar date, YYYY-MM-DD. - type: 'null' description: >- The date of the newest load of this source, YYYY-MM-DD. Null before the first load of this source. stale: type: boolean description: >- True when the newest load failed the freshness rule and the API still serves the previous snapshot. A load fails the rule when the count moved more than 30 percent, or when its newest date is more than 14 days old. required: - source - snapshot_date - stale additionalProperties: false description: >- One city file behind a jurisdiction's short-term rental data: the date of its newest load, and if that load is stale. headers: ETag: description: >- The entity tag of the answer, derived from the dataset version of the markets in the response and from the representation, not from the body. It moves only when a refresh rebuilds the tables of a market. On a JSON route, send it back as If-None-Match, and an unchanged dataset answers 304 with no body. The API streams an export whatever the tag. GET /v1/dataset runs no query, so it is the lowest-cost place to send the tag. On every 2xx and the 304, never on an error. schema: type: string X-Request-Id: description: >- The id of this call. The edge mints it and also sends it as zp-rid, the gateway's own name for it. The API keys its log line for the call on it, and every error body repeats it as request_id. Log it on every response, not only on errors. A refusal the gateway answers itself carries zp-rid and request_id alone. Those refusals are a 401, a 403 quota_exceeded and a 429 at the limit of the plan. schema: type: string X-Rows: description: >- How many rows the body carries: data.length on a list, 1 on a single record. The size of the body, not a charge. Absent on a streamed export, whose count the API knows only when the stream ends, and on a 304. schema: type: integer minimum: 0 X-Dataset-Version: description: >- The dataset version of every market in the response, as market=version pairs joined by commas (phx=1788469819 for one market). The header carries one pair per loaded market. The figures are the same as meta.coverage[].dataset_version, and you can read them without parsing the body. A version moves only when a refresh rebuilds the tables of the market, so fold the label into cache keys. On every 2xx and the 304, never on an error. Absent when the answer names no market: an empty deployment, or a GET /v1/coverage lookup outside every market. schema: type: string X-Data-End: description: >- The last deed date of every market in the response, as market=YYYY-MM-DD pairs joined by commas (phx=2026-08-12 for one market). The header carries one pair per loaded market. The dates are the same as meta.coverage[].data_end. On every 2xx and the 304, never on an error. Absent when the answer names no market: an empty deployment, or a GET /v1/coverage lookup outside every market. schema: type: string Retry-After: description: >- Whole seconds to wait before you retry, never below 1. On a 429, the seconds until the spent bucket refills. On a 503, 1 for pool_saturated and 5 for ledger_unavailable, and none for database_unavailable. On a 403 plan_limit for the name-search day cap, the seconds to the next UTC midnight, when the cap resets. The other plan limits carry none. The body repeats it as retry_after on the 429, the ledger refusal and the day cap. schema: type: integer minimum: 1 securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key from the developer console (starts with zpka_). Create one at https://developers.investorlift.com/get-a-key. ```` ## Related topics - [Read which data is available where](/api-reference/dataset/read-which-data-is-available-where.md) - [Which data is available where](/coverage/markets.md) - [Coverage and freshness](/guides/concepts/coverage.md) - [Privacy notice](/guides/privacy.md) - [Counties, cities and ZIP codes](/coverage/places.md)