Look up by Fieldgeist ID
Fetch one parcel and its address by the Fieldgeist ID a lookup returned.
GET https://api.fieldgeist.com/v1/verify/lookup/{fieldgeist_id}Returns one parcel by its Fieldgeist ID: its address, APN, county FIPS code, coordinates and building ID. Use it to refresh a parcel you matched earlier without matching the address again.
Authentication
Authorization: Bearer <key>. See Authentication.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fieldgeist_id | string | Yes | A parcel's Fieldgeist ID: adr_ followed by a 26-character ULID, such as adr_01JA2Z3Y4X5W6V7T8S9R0QPNMA. Building IDs (bld_…) can't be fetched yet. |
Request example
curl https://api.fieldgeist.com/v1/verify/lookup/adr_01JA2Z3Y4X5W6V7T8S9R0QPNMA \
-H "Authorization: Bearer $FIELDGEIST_API_KEY"Response
Parcel values on this page are illustrative.
200 OK
{
"status": "active",
"fieldgeist_id": "adr_01JA2Z3Y4X5W6V7T8S9R0QPNMA",
"superseded_by": [],
"building_id": null,
"apn": "198520-0495",
"fips": "53033",
"lat": 47.620494,
"lon": -122.349235,
"addressNumber": "400",
"addressNumberSuffix": null,
"predirectional": null,
"streetName": "BROAD",
"streetSuffix": "ST",
"postdirectional": null,
"occupancyId": null,
"city": "SEATTLE",
"state": "WA",
"zip5": "98109",
"zip4": null
}| Field | Type | Description |
|---|---|---|
status | string | active, or superseded when the parcel was split or merged and other IDs replace it. |
fieldgeist_id | string | The ID you asked for. |
superseded_by | string[] | The IDs that replace this one. Empty while active. |
building_id | string | null | The building's ID (bld_…) for a unit parcel. |
apn | string | null | The county's assessor parcel number. |
fips | string | null | 5-digit county FIPS code. |
lat, lon | number | null | Coordinates of the parcel. |
addressNumber, addressNumberSuffix, predirectional, streetName, streetSuffix, postdirectional, occupancyId, city, state, zip5, zip4 | string | null | The parcel's address as the index records it, in Publication 28 form. |
A superseded parcel
{
"status": "superseded",
"fieldgeist_id": "adr_01JA2Z3Y4X5W6V7T8S04242ZZZ",
"superseded_by": ["adr_01JA2Z3Y4X5W6V7T8S99998ZZZ", "adr_01JA2Z3Y4X5W6V7T8S99999ZZZ"],
"building_id": null,
"apn": "SYN-4242",
"...": "..."
}A superseded ID still answers with its last known record. Fetch each ID in superseded_by to get the current parcels.
Errors
| Status | error | Cause |
|---|---|---|
400 | invalid_id | The ID isn't adr_ followed by a 26-character ULID. |
404 | not_found | No parcel has this ID. The response echoes fieldgeist_id. Not billed. |
422 | unsupported_id_type | A building ID (bld_…). Building IDs can't be fetched yet; use a parcel's adr_ ID. |
503 | matchkey_unavailable | The parcel index is unavailable. Retry later. |
401, 402, 403, 429, 5xx | See Errors. |
{ "error": "not_found", "fieldgeist_id": "adr_01JA2Z3Y4X5W6V7T8S9R0QPZZZ" }