A Search query costs $0.20 on Free, whatever fields it returns and however many
matches it finds, including zero. Build and Growth are discounted; see
Pricing. Each page is a new query.
You have criteria, not a location: “Arizona parcels of 100–1,000 acres”.
You want a shortlist of parcels with their identity and a few chosen fields.
You want the same fields for every match in one call.
Search returns the first matches found, not a ranked list. Every filter is an
AND requirement.Use /v1/enrich instead when you already have one address or
coordinate and want each value with its source, confidence and interpretation hints.List every field, its filter operators and whether it can be returned with
GET /v1/search/fields.
Conditions every match must meet. Must include exactly one state2 filter. There is no filter-count limit.
fields
array of strings
no
Names to return for every match: any Search filter name, any Enrich field, or the geometry outputs geometry, parcel_geometry_wkt and parcel_boundary_geojson.
limit
integer
no
Matches per page, 1–100. Default 10. A larger value is rejected, never reduced.
cursor
string
no
The previous page’s next_cursor. Keep filters and fields unchanged.
max_cost_usd
decimal string
no
Spending ceiling for this query, such as "0.20".
Any other top-level property is rejected with 422.
Fuzzy search: matches values written differently (case, punctuation, common abbreviations). Supported fields: mailadd
One state is required inside filters. Use one state2 filter with eq and one
two-letter code. The 50 states and DC are accepted. A county or a polygon does not
replace it. Each Search covers one state; to cover several states,
run one search per state.
county is optional. It takes a five-digit FIPS string such as "04013" (keep the
leading zero) or the name of a county in the requested state. Names ignore case,
punctuation and a trailing County, Parish or Borough: "Prince George's",
"St. Louis County" and "Harris County" all work. A name that matches no county,
or more than one, returns 422 search_invalid_filter with close spellings when there
are any; the FIPS string always works.
scity is the situs-address city. It is not mail_city.
mailadd with match takes one mailing address, such as
"13141 Northwest Fwy Ste 300, Houston, TX 77040". Spellings like Street/St,
Suite/Ste/# and North/N match each other; a different house or suite number does
not. Leave the suite out to match every suite at that street address. A ZIP is required, in the value or as a mail_zip filter with eq. Next to
match, mail_zip only supplies that ZIP.
pvd_gisacre is parcel area in acres, computed from the boundary. gisacre is the
county-reported value.
Send JSON numbers and booleans, not strings. Dates use YYYY-MM-DD; timestamps use
UTC ISO 8601.
null is never a filter value. A parcel with no value for a filtered field does
not match, even with ne.
The Searchable fields page lists every filter name,
its type and unit. Any other name, in filters or fields, returns
422 search_invalid_filter with the message Unknown Search field: <name>.
Up to limit parcels. Count them with matches.length.
next_cursor
string or null
Send as cursor for the next page. null means this is the last page.
remarks
array
Always present. [] when there is nothing to report.
request_id
string
Quote this when contacting support.
billing
object
Dollar receipt: operation_id, currency, charged_usd, pricing_version, replayed.
Each match has:
Key
Notes
parcelnumb
County parcel number (APN). APNs repeat across counties, so keep state2 and county with it.
address, scity
Situs address and city. May be null.
szip5
Five-digit situs ZIP code. May be null.
state2, county
Two-letter state and county name.
pvd_gisacre
Parcel area in acres.
source
Source of the parcel record.
analysis_point
The parcel’s recorded point, used for point-based fields. It can lie outside the boundary.
fields
Values of your scalar filters plus every name in fields.
fields holds plain values. It does not repeat values already at the top level:
filtering on state2 adds nothing, while filtering on a county FIPS code adds
fields.geoid. 0, false and empty lists are real values. Point-based fields
describe analysis_point; parcel calculations describe the whole boundary. For a
value’s source and confidence, call Enrich.
Each remark has a code and a message, and may add:
Key
Meaning
path
The request entry the remark is about, such as fields[1].
hint
A suggested next step.
candidates
Number of candidate parcels the remark covers.
matches
Number of returned matches the remark covers.
Keys without a value are omitted. Branch on code and path only.message and
hint are written for people and may change.
Code
Meaning
What to do
time_limit_reached
The time limit cut this page short.
Continue with next_cursor.
source_unavailable
Parcel data became unavailable partway through. Returned matches are correct.
Continue with next_cursor, or retry later.
candidates_not_checked
Some parcels could not be checked against your filters, so a match may be missing.
Treat the page as possibly incomplete.
field_unavailable
The field at path could not be produced for some matches; it is null there.
Treat those nulls as unknown.
{ "remarks": [ { "code": "field_unavailable", "message": "The field parcel_flood_sfha_fraction could not be produced for some matches on this page; it is null in those matches.", "path": "fields[1]", "matches": 1 } ]}
next_cursor is the only signal that more pages may exist. A short or even empty
page can still carry a cursor, so keep paging until it is null before you say no
more parcels match.
Send the cursor as cursor with the same filters and fields. limit may change.
Cursors expire after one hour. After that, or after 409 dataset_changed, start
again without a cursor.
Each page is a new query with its own price, time limit and Idempotency-Key.
Pages are not a snapshot. Parcel data can change between calls.
Send a stable Idempotency-Key header for each page: 8–128 letters, digits, _,
., : or -. Repeating that key with the same body returns the saved page and its
original receipt without another charge. Reusing a key for a changed body returns
409 idempotency_conflict. With no key, each call is a new query. Hosted MCP
accepts the same value as the idempotency_key argument.Set your HTTP client timeout to at least 210 seconds.
Validation errors return detail.error, message, issues, retryable: false,
docs_url and request_id. Each issue names the input path and gives a correction
hint:
{ "detail": { "error": "search_invalid_filter", "message": "Unknown Search field: example_name.", "retryable": false, "issues": [ { "path": "fields[0]", "message": "Unknown Search field: example_name.", "hint": "Use a filter or field name listed in the Search documentation; names are case-sensitive." } ], "docs_url": "<Search documentation URL>", "request_id": "req_7f3a9c2e41b84d0f" }}
HTTP
Code
Retryable
Meaning
422
search_invalid_request
no
Bad request shape, missing or invalid state2, wrong value type, or an invalid, expired or mismatched cursor.
422
search_invalid_filter
no
Unknown name, an operator or value the field does not support, or more than one state. Run one search per state.
422
search_limit_exceeded
no
limit is above 100.
422
search_query_too_broad
no
The filters match too many parcels to search within the time limit. Narrow them: a county or a tighter acreage range.
429
search_busy
yes
Search is at capacity. Wait for Retry-After (3 seconds).
503
search_unavailable
yes
Parcels could not be read. No no-match conclusion was made. Retry-After: 3.
504
search_deadline_exceeded
yes
The time limit ran out before any parcels were read. Retry-After: 3.
Search also returns the shared account, billing and dataset errors, such as
402 spend_limit_exceeded, 409 dataset_changed and 429 rate_limited. See
Errors. Do not retry an unchanged 422.
10 returned matches per page by default, with a 100-result maximum.
180 seconds per page for finding matches and producing their fields. A page that
runs out of time returns what it found, with a time_limit_reached remark.
There is no filter-count limit.
Polygons: at most 10,000 vertices across all geometry filters, and 1,000,000 km²
per shape. Larger inputs are rejected, never simplified.
All conditions are required; source routing is automatic. Include exactly one state2 filter with eq and one two-letter US state code (50 states and DC). Each Search covers one state; run one search per state. County is optional.
The charge receipt for one paid Search or Enrich operation.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mireye","colors":{"primary":"#0E5C2F","light":"#16A34A","dark":"#0B3D20"},"logo":{"light":"https://mintcdn.com/mireye-58181a65/zsiO7l6DvQLXFAXi/logo/light.svg?fit=max\u0026auto=format\u0026n=zsiO7l6DvQLXFAXi\u0026q=85\u0026s=5714ed8c487b8165cfac87be383944d9","dark":"https://mintcdn.com/mireye-58181a65/zsiO7l6DvQLXFAXi/logo/dark.svg?fit=max\u0026auto=format\u0026n=zsiO7l6DvQLXFAXi\u0026q=85\u0026s=b74f4ca2835aa4896c1052864f9092ee"},"favicon":"https://mintcdn.com/mireye-58181a65/zsiO7l6DvQLXFAXi/favicon.svg?fit=max\u0026auto=format\u0026n=zsiO7l6DvQLXFAXi\u0026q=85\u0026s=c2bb1398d848c317b12624bc2aafbdbd","api":{"openapi":"openapi.json"},"navbar":{"links":[{"href":"https://www.mireye.com/pricing","label":"Pricing"},{"href":"https://github.com/Mireye-Labs/mireye-earth","label":"GitHub"}],"primary":{"type":"button","label":"Get an API key","href":"https://www.mireye.com/signup"}},"footer":{"socials":{"github":"https://github.com/Mireye-Labs/mireye-earth"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mireye-58181a65","hasAudioNarration":false,"actualSubdomain":"mireye-58181a65","customDomains":["docs.mireye.ai"],"gitSource":{"type":"github","owner":"mireye-labs","repo":"mireye-earth","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af0589db63e2f3c3ce28ea2","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API reference","count":26},{"language":"default","tag":"Discover parcels","count":6},{"language":"default","tag":"MCP","count":6},{"language":"default","tag":"Guides","count":5},{"language":"default","tag":"Catalog","count":4},{"language":"default","tag":"Get started","count":4},{"language":"default","tag":"Fetch","count":3},{"language":"default","tag":"Runs","count":3},{"language":"default","tag":"Reference","count":2},{"language":"default","tag":"Ask","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/search","slug":"/api-reference/search","pageMetadata":{"title":"POST /v1/search","description":"Find US parcels that match typed filters, with the fields you choose for each match.","openapi":"POST /v1/search","href":"/api-reference/search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Find US parcels that match typed filters, with the fields you choose for each match.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsxs(_components.p,{children:[`A Search query costs `,_jsx(_components.strong,{children:`$0.20`}),` on Free, whatever fields it returns and however many\nmatches it finds, including zero. Build and Growth are discounted; see\n`,_jsx(_components.a,{href:`/pricing`,children:`Pricing`}),`. Each page is a new query.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`when-to-use-this`,children:`When to use this`}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`/v1/search`}),` when:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`You have criteria, not a location: “Arizona parcels of 100–1,000 acres”.`}),`\n`,_jsx(_components.li,{children:`You want a shortlist of parcels with their identity and a few chosen fields.`}),`\n`,_jsx(_components.li,{children:`You want the same fields for every match in one call.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Search returns the `,_jsx(_components.strong,{children:`first matches found`}),`, not a ranked list. Every filter is an\n`,_jsx(_components.strong,{children:`AND`}),` requirement.`]}),`\n`,_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/api-reference/enrich`,children:_jsx(_components.code,{children:`/v1/enrich`})}),` instead when you already have one address or\ncoordinate and want each value with its source, confidence and interpretation hints.`]}),`\n`,_jsxs(_components.p,{children:[`List every field, its filter operators and whether it can be returned with\n`,_jsx(_components.a,{href:`/api-reference/get-search-fields`,children:_jsx(_components.code,{children:`GET /v1/search/fields`})}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`request-shape`,children:`Request shape`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`filters`})}),_jsx(_components.td,{children:`array`}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`Conditions every match must meet. Must include exactly one `,_jsx(_components.code,{children:`state2`}),` filter. There is no filter-count limit.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fields`})}),_jsx(_components.td,{children:`array of strings`}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[`Names to return for every match: any `,_jsx(_components.a,{href:`/api-reference/search-fields`,children:`Search filter name`}),`, any `,_jsx(_components.a,{href:`/api-reference/enrich-fields`,children:`Enrich field`}),`, or the geometry outputs `,_jsx(_components.code,{children:`geometry`}),`, `,_jsx(_components.code,{children:`parcel_geometry_wkt`}),` and `,_jsx(_components.code,{children:`parcel_boundary_geojson`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`limit`})}),_jsx(_components.td,{children:`integer`}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`Matches per page, 1–100. Default 10. A larger value is rejected, never reduced.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`cursor`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[`The previous page’s `,_jsx(_components.code,{children:`next_cursor`}),`. Keep `,_jsx(_components.code,{children:`filters`}),` and `,_jsx(_components.code,{children:`fields`}),` unchanged.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`max_cost_usd`})}),_jsx(_components.td,{children:`decimal string`}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[`Spending ceiling for this query, such as `,_jsx(_components.code,{children:`\"0.20\"`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Any other top-level property is rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`filters`,children:`Filters`}),`\n`,_jsxs(_components.p,{children:[`Each filter is `,_jsx(_components.code,{children:`{field, op, value}`}),`. Operators:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`op`})}),_jsx(_components.th,{children:`Value`}),_jsx(_components.th,{children:`Applies to`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`eq`}),`, `,_jsx(_components.code,{children:`ne`})]}),_jsx(_components.td,{children:`one value`}),_jsx(_components.td,{children:`Text, boolean and numeric fields`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`in`})}),_jsx(_components.td,{children:`nonempty array`}),_jsx(_components.td,{children:`Text, boolean and numeric fields`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`lt`}),`, `,_jsx(_components.code,{children:`lte`}),`, `,_jsx(_components.code,{children:`gt`}),`, `,_jsx(_components.code,{children:`gte`})]}),_jsx(_components.td,{children:`one number`}),_jsx(_components.td,{children:`Numeric fields, dates and timestamps`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`between`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`[low, high]`}),`, inclusive, ascending`]}),_jsx(_components.td,{children:`Numeric fields, dates and timestamps`})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`intersects`}),`, `,_jsx(_components.code,{children:`within`})]}),_jsx(_components.td,{children:`GeoJSON Polygon or MultiPolygon`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`geometry`}),` only`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`match`})}),_jsx(_components.td,{children:`one string`}),_jsxs(_components.td,{children:[`Fuzzy search: matches values written differently (case, punctuation, common abbreviations). Supported fields: `,_jsx(_components.code,{children:`mailadd`})]})]})]})]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`One state is required inside `,_jsx(_components.code,{children:`filters`}),`.`]}),` Use one `,_jsx(_components.code,{children:`state2`}),` filter with `,_jsx(_components.code,{children:`eq`}),` and one\ntwo-letter code. The 50 states and DC are accepted. A county or a polygon does not\nreplace it. Each Search covers one state; to cover several states,\nrun one search per state.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`county`}),` is optional. It takes a five-digit FIPS string such as `,_jsx(_components.code,{children:`\"04013\"`}),` (keep the\nleading zero) or the name of a county in the requested state. Names ignore case,\npunctuation and a trailing County, Parish or Borough: `,_jsx(_components.code,{children:`\"Prince George's\"`}),`,\n`,_jsx(_components.code,{children:`\"St. Louis County\"`}),` and `,_jsx(_components.code,{children:`\"Harris County\"`}),` all work. A name that matches no county,\nor more than one, returns 422 `,_jsx(_components.code,{children:`search_invalid_filter`}),` with close spellings when there\nare any; the FIPS string always works.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`scity`}),` is the situs-address city. It is not `,_jsx(_components.code,{children:`mail_city`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`mailadd`}),` with `,_jsx(_components.code,{children:`match`}),` takes one mailing address, such as\n`,_jsx(_components.code,{children:`\"13141 Northwest Fwy Ste 300, Houston, TX 77040\"`}),`. Spellings like Street/St,\nSuite/Ste/# and North/N match each other; a different house or suite number does\nnot. Leave the suite out to match every suite at that street address. A ZIP is required, in the value or as a `,_jsx(_components.code,{children:`mail_zip`}),` filter with `,_jsx(_components.code,{children:`eq`}),`. Next to\n`,_jsx(_components.code,{children:`match`}),`, `,_jsx(_components.code,{children:`mail_zip`}),` only supplies that ZIP.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`pvd_gisacre`}),` is parcel area in acres, computed from the boundary. `,_jsx(_components.code,{children:`gisacre`}),` is the\ncounty-reported value.`]}),`\n`,_jsxs(_components.li,{children:[`Send JSON numbers and booleans, not strings. Dates use `,_jsx(_components.code,{children:`YYYY-MM-DD`}),`; timestamps use\nUTC ISO 8601.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`null`}),` is never a filter value. A parcel with no value for a filtered field does\nnot match, even with `,_jsx(_components.code,{children:`ne`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The `,_jsx(_components.a,{href:`/api-reference/search-fields`,children:`Searchable fields`}),` page lists every filter name,\nits type and unit. Any other name, in `,_jsx(_components.code,{children:`filters`}),` or `,_jsx(_components.code,{children:`fields`}),`, returns\n`,_jsx(_components.code,{children:`422 search_invalid_filter`}),` with the message `,_jsx(_components.code,{children:`Unknown Search field: \u003cname>.`})]}),`\n`,_jsx(Heading,{level:`3`,id:`search-inside-a-polygon`,children:`Search inside a polygon`}),`\n`,_jsxs(_components.p,{children:[`Use a `,_jsx(_components.code,{children:`geometry`}),` filter with a WGS84 GeoJSON Polygon or MultiPolygon. Positions are\n`,_jsx(_components.code,{children:`[longitude, latitude]`}),`.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`intersects`}),` matches any parcel that shares area or a boundary point with the shape.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`within`}),` matches only parcels the shape covers entirely.`]}),`\n`,_jsx(_components.li,{children:`Holes are respected. Acreage still means the whole parcel.`}),`\n`,_jsxs(_components.li,{children:[`Send only `,_jsx(_components.code,{children:`type`}),` and `,_jsx(_components.code,{children:`coordinates`}),`: no Feature wrapper, CRS or altitude.`]}),`\n`,_jsx(_components.li,{children:`Rings must be closed and valid. Split shapes that cross the antimeridian into a\nMultiPolygon.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`A geometry filter does not return geometry. Name `,_jsx(_components.code,{children:`parcel_boundary_geojson`}),` in\n`,_jsx(_components.code,{children:`fields`}),` if you want the boundary.`]}),`\n`,_jsx(Heading,{level:`2`,id:`example-arizona-parcels-with-owner-and-zoning`,children:`Example: Arizona parcels with owner and zoning`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`14`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`14`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`SEARCH_KEY`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"$(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`uuidgen`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`)\"`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # keep this to retry the same request`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --max-time`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 210`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.mireye.com/v1/search`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$MIREYE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Idempotency-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$SEARCH_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'content-type: application/json'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"filters\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"field\": \"state2\", \"op\": \"eq\", \"value\": \"AZ\"},`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {\"field\": \"pvd_gisacre\", \"op\": \"between\", \"value\": [100, 1000]}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"fields\": [\"owner\", \"zoning\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"limit\": 2,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"max_cost_usd\": \"0.20\"`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` jq`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`38`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`38`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"matches\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"parcelnumb\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"501-12-004A\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"N 355TH AVE, TONOPAH, AZ 85354\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AZ\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"county\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Maricopa\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"scity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Tonopah\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"szip5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"85354\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PARCEL_VENDOR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pvd_gisacre\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`160.4`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"analysis_point\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"lat\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`33.4931`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"lng\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-112.9472`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"parcel_stored_lat_lon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"DESERT RANCH HOLDINGS LLC\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"zoning\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"RU-43\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"parcelnumb\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"401-30-011\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"address\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"state2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"AZ\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"county\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Maricopa\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"scity\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"szip5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PARCEL_VENDOR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pvd_gisacre\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`322.9`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"analysis_point\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"lat\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`33.0127`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"lng\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`-112.6018`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"method\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"parcel_stored_lat_lon\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fields\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"STATE OF ARIZONA\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"zoning\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"next_cursor\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"eyJ2IjoxLCJrIjoi...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"remarks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_7f3a9c2e41b84d0f\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"billing\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"operation_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"op_4b1d…\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USD\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"charged_usd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.200000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"pricing_version\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"earth-usd-v1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"replayed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Values are illustrative. The `,_jsx(_components.code,{children:`null`}),` zoning above, with no remark, means the parcel\nrecord has no zoning value.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response-shape`,children:`Response shape`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Key`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`matches`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`Up to `,_jsx(_components.code,{children:`limit`}),` parcels. Count them with `,_jsx(_components.code,{children:`matches.length`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`next_cursor`})}),_jsx(_components.td,{children:`string or null`}),_jsxs(_components.td,{children:[`Send as `,_jsx(_components.code,{children:`cursor`}),` for the next page. `,_jsx(_components.code,{children:`null`}),` means this is the last page.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`remarks`})}),_jsx(_components.td,{children:`array`}),_jsxs(_components.td,{children:[`Always present. `,_jsx(_components.code,{children:`[]`}),` when there is nothing to report.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`request_id`})}),_jsx(_components.td,{children:`string`}),_jsx(_components.td,{children:`Quote this when contacting support.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`billing`})}),_jsx(_components.td,{children:`object`}),_jsxs(_components.td,{children:[`Dollar receipt: `,_jsx(_components.code,{children:`operation_id`}),`, `,_jsx(_components.code,{children:`currency`}),`, `,_jsx(_components.code,{children:`charged_usd`}),`, `,_jsx(_components.code,{children:`pricing_version`}),`, `,_jsx(_components.code,{children:`replayed`}),`.`]})]})]})]}),`\n`,_jsx(_components.p,{children:`Each match has:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Key`}),_jsx(_components.th,{children:`Notes`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`parcelnumb`})}),_jsxs(_components.td,{children:[`County parcel number (APN). APNs repeat across counties, so keep `,_jsx(_components.code,{children:`state2`}),` and `,_jsx(_components.code,{children:`county`}),` with it.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`address`}),`, `,_jsx(_components.code,{children:`scity`})]}),_jsxs(_components.td,{children:[`Situs address and city. May be `,_jsx(_components.code,{children:`null`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`szip5`})}),_jsxs(_components.td,{children:[`Five-digit situs ZIP code. May be `,_jsx(_components.code,{children:`null`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`state2`}),`, `,_jsx(_components.code,{children:`county`})]}),_jsx(_components.td,{children:`Two-letter state and county name.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pvd_gisacre`})}),_jsx(_components.td,{children:`Parcel area in acres.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source`})}),_jsx(_components.td,{children:`Source of the parcel record.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`analysis_point`})}),_jsx(_components.td,{children:`The parcel’s recorded point, used for point-based fields. It can lie outside the boundary.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`fields`})}),_jsxs(_components.td,{children:[`Values of your scalar filters plus every name in `,_jsx(_components.code,{children:`fields`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fields`}),` holds plain values. It does not repeat values already at the top level:\nfiltering on `,_jsx(_components.code,{children:`state2`}),` adds nothing, while filtering on a county FIPS code adds\n`,_jsx(_components.code,{children:`fields.geoid`}),`. `,_jsx(_components.code,{children:`0`}),`, `,_jsx(_components.code,{children:`false`}),` and empty lists are real values. Point-based fields\ndescribe `,_jsx(_components.code,{children:`analysis_point`}),`; parcel calculations describe the whole boundary. For a\nvalue’s source and confidence, call `,_jsx(_components.a,{href:`/api-reference/enrich`,children:`Enrich`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`remarks`,children:`Remarks`}),`\n`,_jsxs(_components.p,{children:[`Each remark has a `,_jsx(_components.code,{children:`code`}),` and a `,_jsx(_components.code,{children:`message`}),`, and may add:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Key`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`path`})}),_jsxs(_components.td,{children:[`The request entry the remark is about, such as `,_jsx(_components.code,{children:`fields[1]`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`hint`})}),_jsx(_components.td,{children:`A suggested next step.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`candidates`})}),_jsx(_components.td,{children:`Number of candidate parcels the remark covers.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`matches`})}),_jsx(_components.td,{children:`Number of returned matches the remark covers.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Keys without a value are omitted. `,_jsxs(_components.strong,{children:[`Branch on `,_jsx(_components.code,{children:`code`}),` and `,_jsx(_components.code,{children:`path`}),` only.`]}),` `,_jsx(_components.code,{children:`message`}),` and\n`,_jsx(_components.code,{children:`hint`}),` are written for people and may change.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`What to do`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`time_limit_reached`})}),_jsx(_components.td,{children:`The time limit cut this page short.`}),_jsxs(_components.td,{children:[`Continue with `,_jsx(_components.code,{children:`next_cursor`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`source_unavailable`})}),_jsx(_components.td,{children:`Parcel data became unavailable partway through. Returned matches are correct.`}),_jsxs(_components.td,{children:[`Continue with `,_jsx(_components.code,{children:`next_cursor`}),`, or retry later.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`candidates_not_checked`})}),_jsx(_components.td,{children:`Some parcels could not be checked against your filters, so a match may be missing.`}),_jsx(_components.td,{children:`Treat the page as possibly incomplete.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`field_unavailable`})}),_jsxs(_components.td,{children:[`The field at `,_jsx(_components.code,{children:`path`}),` could not be produced for some matches; it is `,_jsx(_components.code,{children:`null`}),` there.`]}),_jsx(_components.td,{children:`Treat those nulls as unknown.`})]})]})]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"remarks\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"field_unavailable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"The field parcel_flood_sfha_fraction could not be produced for some matches on this page; it is null in those matches.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fields[1]\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"matches\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Remarks never change the price.`}),`\n`,_jsx(Heading,{level:`3`,id:`paging`,children:`Paging`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`next_cursor`}),` is the only signal that more pages may exist. A short or even empty\npage can still carry a cursor, so keep paging until it is `,_jsx(_components.code,{children:`null`}),` before you say no\nmore parcels match.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Send the cursor as `,_jsx(_components.code,{children:`cursor`}),` with the same `,_jsx(_components.code,{children:`filters`}),` and `,_jsx(_components.code,{children:`fields`}),`. `,_jsx(_components.code,{children:`limit`}),` may change.`]}),`\n`,_jsxs(_components.li,{children:[`Cursors expire after one hour. After that, or after `,_jsx(_components.code,{children:`409 dataset_changed`}),`, start\nagain without a cursor.`]}),`\n`,_jsxs(_components.li,{children:[`Each page is a new query with its own price, time limit and `,_jsx(_components.code,{children:`Idempotency-Key`}),`.`]}),`\n`,_jsx(_components.li,{children:`Pages are not a snapshot. Parcel data can change between calls.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`retries`,children:`Retries`}),`\n`,_jsxs(_components.p,{children:[`Send a stable `,_jsx(_components.code,{children:`Idempotency-Key`}),` header for each page: 8–128 letters, digits, `,_jsx(_components.code,{children:`_`}),`,\n`,_jsx(_components.code,{children:`.`}),`, `,_jsx(_components.code,{children:`:`}),` or `,_jsx(_components.code,{children:`-`}),`. Repeating that key with the same body returns the saved page and its\noriginal receipt without another charge. Reusing a key for a changed body returns\n`,_jsx(_components.code,{children:`409 idempotency_conflict`}),`. With no key, each call is a new query. Hosted MCP\naccepts the same value as the `,_jsx(_components.code,{children:`idempotency_key`}),` argument.`]}),`\n`,_jsx(_components.p,{children:`Set your HTTP client timeout to at least 210 seconds.`}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`Validation errors return `,_jsx(_components.code,{children:`detail.error`}),`, `,_jsx(_components.code,{children:`message`}),`, `,_jsx(_components.code,{children:`issues`}),`, `,_jsx(_components.code,{children:`retryable: false`}),`,\n`,_jsx(_components.code,{children:`docs_url`}),` and `,_jsx(_components.code,{children:`request_id`}),`. Each issue names the input `,_jsx(_components.code,{children:`path`}),` and gives a correction\n`,_jsx(_components.code,{children:`hint`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`16`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"detail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"search_invalid_filter\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unknown Search field: example_name.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"retryable\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`false`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"issues\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"path\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fields[0]\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Unknown Search field: example_name.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"hint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Use a filter or field name listed in the Search documentation; names are case-sensitive.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"docs_url\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"\u003cSearch documentation URL>\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"req_7f3a9c2e41b84d0f\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Retryable`}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_invalid_request`})}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[`Bad request shape, missing or invalid `,_jsx(_components.code,{children:`state2`}),`, wrong value type, or an invalid, expired or mismatched `,_jsx(_components.code,{children:`cursor`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_invalid_filter`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`Unknown name, an operator or value the field does not support, or more than one state. Run one search per state.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_limit_exceeded`})}),_jsx(_components.td,{children:`no`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`limit`}),` is above 100.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`422`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_query_too_broad`})}),_jsx(_components.td,{children:`no`}),_jsx(_components.td,{children:`The filters match too many parcels to search within the time limit. Narrow them: a county or a tighter acreage range.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_busy`})}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`Search is at capacity. Wait for `,_jsx(_components.code,{children:`Retry-After`}),` (3 seconds).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_unavailable`})}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`Parcels could not be read. No no-match conclusion was made. `,_jsx(_components.code,{children:`Retry-After: 3`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`504`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`search_deadline_exceeded`})}),_jsx(_components.td,{children:`yes`}),_jsxs(_components.td,{children:[`The time limit ran out before any parcels were read. `,_jsx(_components.code,{children:`Retry-After: 3`}),`.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`Search also returns the shared account, billing and dataset errors, such as\n`,_jsx(_components.code,{children:`402 spend_limit_exceeded`}),`, `,_jsx(_components.code,{children:`409 dataset_changed`}),` and `,_jsx(_components.code,{children:`429 rate_limited`}),`. See\n`,_jsx(_components.a,{href:`/api-reference/errors`,children:`Errors`}),`. Do not retry an unchanged `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`10 returned matches per page`}),` by default, with a `,_jsx(_components.strong,{children:`100-result maximum`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`180 seconds`}),` per page for finding matches and producing their fields. A page that\nruns out of time returns what it found, with a `,_jsx(_components.code,{children:`time_limit_reached`}),` remark.`]}),`\n`,_jsx(_components.li,{children:`There is no filter-count limit.`}),`\n`,_jsx(_components.li,{children:`Polygons: at most 10,000 vertices across all geometry filters, and 1,000,000 km²\nper shape. Larger inputs are rejected, never simplified.`}),`\n`,_jsx(_components.li,{children:`Cursors expire after one hour.`}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"POST /v1/search","description":"Find US parcels that match typed filters, with the fields you choose for each match.","openapi":"POST /v1/search","href":"/api-reference/search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"When to use this","slug":"when-to-use-this","depth":2,"children":[]},{"title":"Request shape","slug":"request-shape","depth":2,"children":[{"title":"Filters","slug":"filters","depth":3,"children":[]},{"title":"Search inside a polygon","slug":"search-inside-a-polygon","depth":3,"children":[]}]},{"title":"Example: Arizona parcels with owner and zoning","slug":"example-arizona-parcels-with-owner-and-zoning","depth":2,"children":[]},{"title":"Response shape","slug":"response-shape","depth":2,"children":[{"title":"Remarks","slug":"remarks","depth":3,"children":[]},{"title":"Paging","slug":"paging","depth":3,"children":[]}]},{"title":"Retries","slug":"retries","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]},{"title":"Limits","slug":"limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Find US parcels that match typed filters, with the fields you choose for each match.","operationId":"search_v1_search_post","parameters":["3f3a5f97-31c9-4e9f-a8cf-58be97456b53"],"requestBody":"121185e2-4128-4745-ab48-b4861d94d58d","responses":{"200":"1e3489ff-9300-4bfe-a146-ab11907a9aa7","401":"fb4b944e-0bee-4f6d-8dbc-b714bf78b25f","402":"17cc3592-1224-4a1c-a63f-022f21d1a515","403":"c009e4cc-4f94-4448-bcf3-9dd3b028591e","409":"0767f837-d98f-4691-8f61-507f61cf0ae1","410":"b6866a9b-6e47-472c-8f7a-7340e0174b28","422":"cb067426-9f13-45e1-adbd-79969c5eecd4","429":"e07c5efe-7aab-4699-af7c-e89a784ffdda","503":"433801dc-df0f-41cd-bfdb-266b9cefd7ca","504":"221ac1d0-8ad6-4e35-8c3f-b2590a48a185"},"summary":"Find parcels matching all filters","method":"post","type":"path","servers":["addab782-b90a-4886-b80c-9a5939b45f70"],"security":[],"path":"/v1/search","baseUrlOptions":["https://api.mireye.com"],"title":"Find parcels matching all filters","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3f3a5f97-31c9-4e9f-a8cf-58be97456b53":{"in":"header","name":"Idempotency-Key","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"}}},"requestBody":{"content":{"application/json":{"examples":{"acreage":{"title":"acreage","value":{"fields":["owner","zoning"],"filters":[{"field":"state2","op":"eq","value":"AZ"},{"field":"pvd_gisacre","op":"between","value":[100,1000]}],"limit":10,"max_cost_usd":"0.20"}},"area_and_slope":{"title":"area_and_slope","value":{"fields":["owner","parcel_boundary_geojson"],"filters":[{"field":"state2","op":"eq","value":"TX"},{"field":"geometry","op":"intersects","value":{"coordinates":[[[-97.8,30.25],[-97.7,30.25],[-97.7,30.35],[-97.8,30.35],[-97.8,30.25]]],"type":"Polygon"}},{"field":"slope_degrees","op":"lte","value":5}],"limit":5}},"next_page":{"title":"next_page","value":{"cursor":"\u003cnext_cursor from the previous page>","fields":["owner","zoning"],"filters":[{"field":"state2","op":"eq","value":"AZ"},{"field":"pvd_gisacre","op":"between","value":[100,1000]}],"limit":10}}},"schema":{"additionalProperties":false,"properties":{"filters":{"description":"All conditions are required; source routing is automatic. Include exactly one state2 filter with eq and one two-letter US state code (50 states and DC). Each Search covers one state; run one search per state. County is optional.","items":{"additionalProperties":false,"properties":{"field":{"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","title":"Field","type":"string","isRequired":true,"uniqueKey":"filters.items.[INDEX].field","typeLabel":"string"},"op":{"enum":["eq","ne","lt","lte","gt","gte","in","between","intersects","within","match"],"title":"Op","type":"string","isRequired":true,"uniqueKey":"filters.items.[INDEX].op","typeLabel":"enum\u003cstring>"},"value":{"oneOf":[{"isRequired":true}],"isRequired":true,"uniqueKey":"filters.items.[INDEX].value","typeLabel":"any"}},"required":["field","op","value"],"title":"SearchFilter","type":"object","uniqueKey":"filters.items.[INDEX]","typeLabel":"SearchFilter · object"},"minItems":1,"title":"Filters","type":"array","isRequired":true,"uniqueKey":"filters","typeLabel":"SearchFilter · object[]"},"cursor":{"oneOf":[{"type":"string","title":"Cursor","maxLength":2048,"minLength":1,"uniqueKey":"cursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Cursor","uniqueKey":"cursor.oneOf.1","typeLabel":"null"}],"uniqueKey":"cursor","typeLabel":"string | null"},"fields":{"description":"Public Search or Enrich fields to return alongside filter values. Results omit values already present in the parcel identity.","items":{"minLength":1,"pattern":"^[a-z][a-z0-9_]*$","type":"string","uniqueKey":"fields.items.[INDEX]","typeLabel":"string"},"title":"Fields","type":"array","uniqueKey":"fields","typeLabel":"string[]"},"limit":{"default":10,"description":"Parcels on this page, from 1 to 100; may change between cursor requests.","minimum":1,"title":"Limit","type":"integer","uniqueKey":"limit","typeLabel":"integer"},"max_cost_usd":{"oneOf":[{"type":"string","title":"Max Cost Usd","pattern":"^(?:0|[1-9][0-9]*)(?:\\.[0-9]{1,6})?$","uniqueKey":"max_cost_usd.oneOf.0","typeLabel":"string"},{"type":"null","title":"Max Cost Usd","uniqueKey":"max_cost_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"max_cost_usd","typeLabel":"string | null"}},"required":["filters"],"title":"SearchRequest","type":"object","uniqueKey":"","typeLabel":"SearchRequest · object"},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"1e3489ff-9300-4bfe-a146-ab11907a9aa7":{"content":{"application/json":{"examples":{"page":{"title":"page","value":{"billing":{"charged_usd":"0.200000","currency":"USD","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","pricing_version":"earth-usd-v1","replayed":false},"matches":[{"address":"100 EXAMPLE ROAD, EXAMPLE CITY, AZ","analysis_point":{"lat":33.4,"lng":-111.9,"method":"parcel_stored_lat_lon"},"county":"Example County","fields":{"owner":"EXAMPLE LAND LLC","zoning":"AG"},"parcelnumb":"001-002","pvd_gisacre":240,"scity":"Example City","source":"PARCEL_VENDOR","state2":"AZ","szip5":"85001"}],"next_cursor":"\u003copaque continuation token>","remarks":[],"request_id":"req_0123456789ab"}},"remarks":{"title":"remarks","value":{"billing":{"charged_usd":"0.200000","currency":"USD","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","pricing_version":"earth-usd-v1","replayed":false},"matches":[{"address":"100 EXAMPLE ROAD, EXAMPLE CITY, AZ","analysis_point":{"lat":33.4,"lng":-111.9,"method":"parcel_stored_lat_lon"},"county":"Example County","fields":{"owner":"EXAMPLE LAND LLC","zoning":null},"parcelnumb":"001-002","pvd_gisacre":240,"scity":"Example City","source":"PARCEL_VENDOR","state2":"AZ","szip5":"85001"}],"next_cursor":null,"remarks":[{"code":"field_unavailable","hint":"A null here means the value could not be produced, not that the parcel lacks it.","matches":1,"message":"The field zoning could not be produced for some matches on this page; it is null in those matches.","path":"fields[1]"}],"request_id":"req_0123456789ab"}}},"schema":{"additionalProperties":false,"properties":{"matches":{"items":{"additionalProperties":false,"properties":{"address":{"oneOf":[{"type":"string","title":"Address","isRequired":true,"uniqueKey":"matches.items.[INDEX].address.oneOf.0","typeLabel":"string"},{"type":"null","title":"Address","isRequired":true,"uniqueKey":"matches.items.[INDEX].address.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].address","typeLabel":"string | null"},"analysis_point":{"additionalProperties":false,"properties":{"lat":{"title":"Lat","type":"number","isRequired":true,"uniqueKey":"matches.items.[INDEX].analysis_point.lat","typeLabel":"number"},"lng":{"title":"Lng","type":"number","isRequired":true,"uniqueKey":"matches.items.[INDEX].analysis_point.lng","typeLabel":"number"},"method":{"const":"parcel_stored_lat_lon","title":"Method","type":"string","isRequired":true,"uniqueKey":"matches.items.[INDEX].analysis_point.method","typeLabel":"string"}},"required":["lat","lng","method"],"title":"SearchPoint","type":"object","isRequired":true,"uniqueKey":"matches.items.[INDEX].analysis_point","typeLabel":"SearchPoint · object"},"county":{"oneOf":[{"type":"string","title":"County","isRequired":true,"uniqueKey":"matches.items.[INDEX].county.oneOf.0","typeLabel":"string"},{"type":"null","title":"County","isRequired":true,"uniqueKey":"matches.items.[INDEX].county.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].county","typeLabel":"string | null"},"fields":{"additionalProperties":{"oneOf":[{}],"uniqueKey":"matches.items.[INDEX].fields.additionalProperties","typeLabel":"any"},"title":"Fields","type":"object","isRequired":true,"uniqueKey":"matches.items.[INDEX].fields","typeLabel":"Fields · object"},"parcelnumb":{"oneOf":[{"type":"string","title":"Parcelnumb","isRequired":true,"uniqueKey":"matches.items.[INDEX].parcelnumb.oneOf.0","typeLabel":"string"},{"type":"null","title":"Parcelnumb","isRequired":true,"uniqueKey":"matches.items.[INDEX].parcelnumb.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].parcelnumb","typeLabel":"string | null"},"pvd_gisacre":{"oneOf":[{"type":"number","title":"Pvd Gisacre","isRequired":true,"uniqueKey":"matches.items.[INDEX].pvd_gisacre.oneOf.0","typeLabel":"number"},{"type":"null","title":"Pvd Gisacre","isRequired":true,"uniqueKey":"matches.items.[INDEX].pvd_gisacre.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].pvd_gisacre","typeLabel":"number | null"},"scity":{"oneOf":[{"type":"string","title":"Scity","isRequired":true,"uniqueKey":"matches.items.[INDEX].scity.oneOf.0","typeLabel":"string"},{"type":"null","title":"Scity","isRequired":true,"uniqueKey":"matches.items.[INDEX].scity.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].scity","typeLabel":"string | null"},"source":{"title":"Source","type":"string","isRequired":true,"uniqueKey":"matches.items.[INDEX].source","typeLabel":"string"},"state2":{"oneOf":[{"type":"string","title":"State2","isRequired":true,"uniqueKey":"matches.items.[INDEX].state2.oneOf.0","typeLabel":"string"},{"type":"null","title":"State2","isRequired":true,"uniqueKey":"matches.items.[INDEX].state2.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].state2","typeLabel":"string | null"},"szip5":{"oneOf":[{"type":"string","title":"Szip5","isRequired":true,"uniqueKey":"matches.items.[INDEX].szip5.oneOf.0","typeLabel":"string"},{"type":"null","title":"Szip5","isRequired":true,"uniqueKey":"matches.items.[INDEX].szip5.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"matches.items.[INDEX].szip5","typeLabel":"string | null"}},"required":["parcelnumb","address","state2","county","scity","szip5","source","pvd_gisacre","analysis_point","fields"],"title":"SearchMatch","type":"object","uniqueKey":"matches.items.[INDEX]","typeLabel":"SearchMatch · object"},"title":"Matches","type":"array","isRequired":true,"uniqueKey":"matches","typeLabel":"SearchMatch · object[]"},"next_cursor":{"oneOf":[{"type":"string","title":"Next Cursor","isRequired":true,"uniqueKey":"next_cursor.oneOf.0","typeLabel":"string"},{"type":"null","title":"Next Cursor","isRequired":true,"uniqueKey":"next_cursor.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"next_cursor","typeLabel":"string | null"},"remarks":{"items":{"additionalProperties":false,"description":"Something the caller should know about this page; branch on code and path only.\n\nmessage and hint are free text and may change without notice. A key with no\nvalue is omitted, never sent as null.","properties":{"code":{"enum":["time_limit_reached","source_unavailable","candidates_not_checked","field_unavailable"],"title":"Code","type":"string","isRequired":true,"uniqueKey":"remarks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"remarks.items.[INDEX].message","typeLabel":"string"},"candidates":{"minimum":1,"title":"Candidates","type":"integer","uniqueKey":"remarks.items.[INDEX].candidates","typeLabel":"integer"},"hint":{"title":"Hint","type":"string","uniqueKey":"remarks.items.[INDEX].hint","typeLabel":"string"},"matches":{"minimum":1,"title":"Matches","type":"integer","uniqueKey":"remarks.items.[INDEX].matches","typeLabel":"integer"},"path":{"title":"Path","type":"string","uniqueKey":"remarks.items.[INDEX].path","typeLabel":"string"}},"required":["code","message"],"title":"SearchRemark","type":"object","uniqueKey":"remarks.items.[INDEX]","typeLabel":"SearchRemark · object"},"title":"Remarks","type":"array","isRequired":true,"uniqueKey":"remarks","typeLabel":"SearchRemark · object[]"},"request_id":{"title":"Request Id","type":"string","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"billing":{"oneOf":[{"type":"object","title":"PaidBilling","description":"The charge receipt for one paid Search or Enrich operation.","required":["operation_id","currency","charged_usd","pricing_version","replayed"],"properties":{"charged_usd":{"description":"Amount charged, as a decimal USD string.","title":"Charged Usd","type":"string","isRequired":true,"uniqueKey":"billing.oneOf.0.charged_usd","typeLabel":"string"},"currency":{"const":"USD","title":"Currency","type":"string","isRequired":true,"uniqueKey":"billing.oneOf.0.currency","typeLabel":"string"},"operation_id":{"description":"Stable identity of this paid operation.","title":"Operation Id","type":"string","isRequired":true,"uniqueKey":"billing.oneOf.0.operation_id","typeLabel":"string"},"pricing_version":{"description":"Rate card the charge used.","title":"Pricing Version","type":"string","isRequired":true,"uniqueKey":"billing.oneOf.0.pricing_version","typeLabel":"string"},"replayed":{"description":"True when this response replays an earlier result without a new charge.","title":"Replayed","type":"boolean","isRequired":true,"uniqueKey":"billing.oneOf.0.replayed","typeLabel":"boolean"}},"additionalProperties":false,"uniqueKey":"billing.oneOf.0","typeLabel":"PaidBilling · object"},{"type":"null","uniqueKey":"billing.oneOf.1","typeLabel":"null"}],"uniqueKey":"billing","typeLabel":"PaidBilling · object | null"}},"required":["matches","next_cursor","remarks","request_id"],"title":"SearchResponse","type":"object","uniqueKey":"","typeLabel":"SearchResponse · object"},"exampleType":"examples"}},"description":"Successful Response","exampleType":"examples"},"fb4b944e-0bee-4f6d-8dbc-b714bf78b25f":{"content":{"application/json":{"examples":{"invalid":{"title":"invalid","value":{"detail":{"error":"auth_invalid","message":"API token is invalid or revoked."}}},"missing":{"title":"missing","value":{"detail":{"error":"auth_missing","message":"An API key or sign-in credential is required."}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"Missing or invalid credential.","exampleType":"examples"},"17cc3592-1224-4a1c-a63f-022f21d1a515":{"content":{"application/json":{"examples":{"limit":{"title":"limit","value":{"detail":{"error":"spend_limit_exceeded","message":"The operation exceeds the available balance or spending limit.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":false}}},"paused":{"title":"paused","value":{"detail":{"error":"spending_paused","message":"Paid usage is paused for this account.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":false}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"The charge would exceed the balance or spending limit.","exampleType":"examples"},"c009e4cc-4f94-4448-bcf3-9dd3b028591e":{"content":{"application/json":{"examples":{"reauthorize":{"title":"reauthorize","value":{"detail":{"error":"reauthorization_required","message":"Reconnect with an active credential."}}},"terms":{"title":"terms","value":{"detail":{"accept_url":"https://www.mireye.com/dashboard","error":"terms_required","message":"Accept the current Earth customer terms at https://www.mireye.com/dashboard, then retry."}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"Current terms or a licensed credential grant is required.","exampleType":"examples"},"0767f837-d98f-4691-8f61-507f61cf0ae1":{"content":{"application/json":{"examples":{"conflict":{"title":"conflict","value":{"detail":{"error":"idempotency_conflict","message":"This key belongs to different request parameters.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":false}}},"in_progress":{"title":"in_progress","value":{"detail":{"error":"operation_in_progress","message":"Work is in progress; retry the same operation.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":true}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"The Idempotency-Key is in use.","exampleType":"examples"},"b6866a9b-6e47-472c-8f7a-7340e0174b28":{"content":{"application/json":{"examples":{"expired":{"title":"expired","value":{"detail":{"error":"result_expired","message":"The saved result has expired.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":false}}},"failed":{"title":"failed","value":{"detail":{"error":"operation_failed","message":"This operation ended without a billed result.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":false}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"The operation for this Idempotency-Key cannot be delivered again.","exampleType":"examples"},"cb067426-9f13-45e1-adbd-79969c5eecd4":{"content":{"application/json":{"examples":{"more_than_one_state":{"title":"more_than_one_state","value":{"detail":{"docs_url":"https://docs.mireye.ai/api-reference/search","error":"search_invalid_filter","issues":[{"hint":"Search covers one state per request. Run one search per state and combine the results.","message":"Search accepts one state per request; this state2 filter names 2 states.","path":"filters[0].value"}],"message":"Search accepts one state per request; this state2 filter names 2 states.","request_id":"req_0123456789ab","retryable":false}}},"unknown_field":{"title":"unknown_field","value":{"detail":{"docs_url":"https://docs.mireye.ai/api-reference/search-fields","error":"search_invalid_filter","issues":[{"hint":"Use a filter or field name listed in the Search documentation; names are case-sensitive.","message":"Unknown Search field: ownr.","path":"fields[0]"}],"message":"Unknown Search field: ownr.","request_id":"req_0123456789ab","retryable":false}}}},"schema":{"additionalProperties":false,"properties":{"detail":{"additionalProperties":false,"properties":{"docs_url":{"title":"Docs Url","type":"string","isRequired":true,"uniqueKey":"detail.docs_url","typeLabel":"string"},"error":{"enum":["search_invalid_request","search_invalid_filter","search_limit_exceeded","search_query_too_broad"],"title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"enum\u003cstring>"},"issues":{"items":{"additionalProperties":false,"properties":{"hint":{"title":"Hint","type":"string","isRequired":true,"uniqueKey":"detail.issues.items.[INDEX].hint","typeLabel":"string"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.issues.items.[INDEX].message","typeLabel":"string"},"path":{"title":"Path","type":"string","isRequired":true,"uniqueKey":"detail.issues.items.[INDEX].path","typeLabel":"string"},"expected":{"oneOf":[{"type":"string","title":"Expected","uniqueKey":"detail.issues.items.[INDEX].expected.oneOf.0","typeLabel":"string"},{"type":"null","title":"Expected","uniqueKey":"detail.issues.items.[INDEX].expected.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.issues.items.[INDEX].expected","typeLabel":"string | null"}},"required":["path","message","hint"],"title":"SearchIssue","type":"object","uniqueKey":"detail.issues.items.[INDEX]","typeLabel":"SearchIssue · object"},"title":"Issues","type":"array","isRequired":true,"uniqueKey":"detail.issues","typeLabel":"SearchIssue · object[]"},"message":{"title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"request_id":{"title":"Request Id","type":"string","isRequired":true,"uniqueKey":"detail.request_id","typeLabel":"string"},"retryable":{"const":false,"title":"Retryable","type":"boolean","isRequired":true,"uniqueKey":"detail.retryable","typeLabel":"boolean"},"operation_id":{"oneOf":[{"type":"string","title":"Operation Id","uniqueKey":"detail.operation_id.oneOf.0","typeLabel":"string"},{"type":"null","title":"Operation Id","uniqueKey":"detail.operation_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.operation_id","typeLabel":"string | null"}},"required":["error","message","retryable","issues","docs_url","request_id"],"title":"SearchErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"SearchErrorDetail · object"}},"required":["detail"],"title":"SearchErrorResponse","type":"object","uniqueKey":"","typeLabel":"SearchErrorResponse · object"},"exampleType":"examples"}},"description":"Invalid request, unknown filter or field name or more than one state (search_invalid_filter), a limit above 100 (search_limit_exceeded), or filters too broad to search within the time limit (search_query_too_broad).","exampleType":"examples"},"e07c5efe-7aab-4699-af7c-e89a784ffdda":{"content":{"application/json":{"examples":{"capacity":{"title":"capacity","value":{"detail":{"error":"search_busy","message":"Search is at capacity; retry shortly.","retryable":true}}},"rate_limited":{"title":"rate_limited","value":{"detail":{"error":"rate_limited","limit_rpm":20,"message":"Rate limit exceeded for the Free plan (20 requests/min). Retry in 12s.","plan":"free","retry_after_s":12}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"Rate limit or capacity reached; honor the Retry-After header.","headers":{"Retry-After":{"description":"Seconds to wait before retrying (3 for search_busy).","schema":{"type":"integer"}}},"exampleType":"examples"},"433801dc-df0f-41cd-bfdb-266b9cefd7ca":{"content":{"application/json":{"examples":{"billing":{"title":"billing","value":{"detail":{"error":"billing_unavailable","message":"Billing is temporarily unavailable; retry the same operation.","operation_id":"op_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef","retryable":true}}},"unavailable":{"title":"unavailable","value":{"detail":{"error":"search_unavailable","message":"Stored parcel search is unavailable; no no-match conclusion was made.","retryable":true}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"Parcel search or billing is temporarily unavailable.","exampleType":"examples"},"221ac1d0-8ad6-4e35-8c3f-b2590a48a185":{"content":{"application/json":{"examples":{"deadline":{"title":"deadline","value":{"detail":{"error":"search_deadline_exceeded","message":"Parcel filtering timed out.","retryable":true}}}},"schema":{"properties":{"detail":{"additionalProperties":true,"properties":{"error":{"description":"Stable machine-readable code; branch on this.","title":"Error","type":"string","isRequired":true,"uniqueKey":"detail.error","typeLabel":"string"},"message":{"description":"Human-readable explanation; wording may change.","title":"Message","type":"string","isRequired":true,"uniqueKey":"detail.message","typeLabel":"string"},"retryable":{"oneOf":[{"type":"boolean","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.0","typeLabel":"boolean"},{"type":"null","title":"Retryable","description":"Whether retrying can succeed.","uniqueKey":"detail.retryable.oneOf.1","typeLabel":"null"}],"uniqueKey":"detail.retryable","typeLabel":"boolean | null"}},"required":["error","message"],"title":"ErrorDetail","type":"object","isRequired":true,"uniqueKey":"detail","typeLabel":"ErrorDetail · object"}},"required":["detail"],"title":"ErrorResponse","type":"object","uniqueKey":"","typeLabel":"ErrorResponse · object"},"exampleType":"examples"}},"description":"Parcel filtering timed out before any page was read.","exampleType":"examples"}},"security":{},"servers":{"addab782-b90a-4886-b80c-9a5939b45f70":{"description":"Production","url":"https://api.mireye.com"}}},"originalFileLocation":"openapi.json"},"subdomain":"mireye-58181a65","siteName":"Mireye","title":"POST /v1/search - Mireye","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T11:51:45.675Z","originalFileLocation":"api-reference/search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Find US parcels that match typed filters, with the fields you choose for each match.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mireye\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"POST /v1/search - Mireye\">\u003cmeta data-mint-head property=\"og:description\" content=\"Find US parcels that match typed filters, with the fields you choose for each match.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mireye\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mireye.ai/api-reference/search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mireye-58181a65.mintlify.site/_mintlify/api/og/v2?division=Discover+parcels\u0026amp;title=POST+%2Fv1%2Fsearch\u0026amp;description=Find+US+parcels+that+match+typed+filters%2C+with+the+fields+you+choose+for+each+match.\u0026amp;theme=22c86cabea284b30e354f833\u0026amp;signature=9d248f9a8e139d91d4d6f648aef3e3a323cc5a6119592ccaa15682933ed3818c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"POST /v1/search - Mireye\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Find US parcels that match typed filters, with the fields you choose for each match.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mireye-58181a65.mintlify.site/_mintlify/api/og/v2?division=Discover+parcels\u0026amp;title=POST+%2Fv1%2Fsearch\u0026amp;description=Find+US+parcels+that+match+typed+filters%2C+with+the+fields+you+choose+for+each+match.\u0026amp;theme=22c86cabea284b30e354f833\u0026amp;signature=9d248f9a8e139d91d4d6f648aef3e3a323cc5a6119592ccaa15682933ed3818c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mireye-58181a65/IkcLneXO-Xfm7c2i/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mireye\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0E5C2F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mireye.ai/api-reference/search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mireye.ai/#organization\",\"name\":\"Mireye\",\"url\":\"https://docs.mireye.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mireye-58181a65/zsiO7l6DvQLXFAXi/logo/light.svg?fit=max\u0026auto=format\u0026n=zsiO7l6DvQLXFAXi\u0026q=85\u0026s=5714ed8c487b8165cfac87be383944d9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mireye.ai#website\",\"name\":\"Mireye\",\"url\":\"https://docs.mireye.ai\",\"publisher\":{\"@id\":\"https://docs.mireye.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mireye.ai/api-reference/search#webpage\",\"url\":\"https://docs.mireye.ai/api-reference/search\",\"name\":\"POST /v1/search\",\"description\":\"Find US parcels that match typed filters, with the fields you choose for each match.\",\"dateModified\":\"2026-11-05T11:51:45.675Z\",\"isPartOf\":{\"@id\":\"https://docs.mireye.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mireye.ai/api-reference/search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mireye.ai/api-reference/search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Mireye\",\"item\":\"https://docs.mireye.ai\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"POST /v1/search\",\"item\":\"https://docs.mireye.ai/api-reference/search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mireye.ai/api-reference/search#apireference\",\"headline\":\"POST /v1/search\",\"name\":\"POST /v1/search\",\"description\":\"Find US parcels that match typed filters, with the fields you choose for each match.\",\"url\":\"https://docs.mireye.ai/api-reference/search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mireye.ai/api-reference/search#webpage\"},\"dateModified\":\"2026-11-05T11:51:45.675Z\",\"publisher\":{\"@id\":\"https://docs.mireye.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mireye.ai#website\"}}]}\u003c/script>","siteName":"Mireye","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","icon":"rectangle-terminal","groups":[{"group":"Ask","pages":[{"title":"POST /v1/ask","openapi":"POST /v1/ask","href":"/api-reference/ask"},{"title":"POST /v1/ask/stream","openapi":"POST /v1/ask/stream","href":"/api-reference/ask-stream"}]},{"group":"Fetch","pages":[{"title":"POST /v1/fetch","openapi":"POST /v1/fetch","href":"/api-reference/fetch"},{"title":"POST /v1/x402/fetch","openapi":"POST /v1/x402/fetch","href":"/api-reference/x402-fetch"},{"title":"POST /v1/fetch/batch","openapi":"POST /v1/fetch/batch","href":"/api-reference/fetch-batch"}]},{"group":"Runs","pages":[{"title":"POST /v1/runs","openapi":"POST /v1/runs","href":"/api-reference/runs"},{"title":"GET /v1/runs/{run_id}/events","openapi":"GET /v1/runs/{run_id}/events","href":"/api-reference/run-events"},{"title":"GET /v1/runs/{run_id}/artifacts/{fmt}","openapi":"GET /v1/runs/{run_id}/artifacts/{fmt}","href":"/api-reference/run-artifacts"}]},{"group":"Sites","pages":[{"title":"Prepare a site","openapi":"POST /v1/sites","href":"/api-reference/sites"},{"title":"POST /v1/ask-site","openapi":"POST /v1/ask-site","href":"/api-reference/ask-site"}]},{"group":"Location utilities","pages":[{"title":"POST /v1/geocode","openapi":"POST /v1/geocode","href":"/api-reference/geocode"},{"title":"POST /v1/proximity","description":"Drive-time distance, nearest-candidate, proximity screening, and labor-shed compute across multiple US + Canada coordinates.","openapi":"POST /v1/proximity","href":"/api-reference/proximity"}]},{"group":"Discover parcels","pages":[{"title":"POST /v1/search","openapi":"POST /v1/search","href":"/api-reference/search"},{"title":"Searchable fields","description":"Search filter names, types and units; Enrich has a separate output catalog.","href":"/api-reference/search-fields"},{"title":"GET /v1/search/fields","openapi":"GET /v1/search/fields","href":"/api-reference/get-search-fields"},{"title":"POST /v1/enrich","openapi":"POST /v1/enrich","href":"/api-reference/enrich"},{"title":"Enrich fields","href":"/api-reference/enrich-fields"},{"title":"GET /v1/enrich/fields","openapi":"GET /v1/enrich/fields","href":"/api-reference/get-enrich-fields"}]},{"group":"Catalog","pages":[{"title":"GET /v1/meta/fields","openapi":"GET /v1/meta/fields","href":"/api-reference/meta-fields"},{"title":"Field catalog","href":"/api-reference/field-catalog"},{"title":"POST /v1/field-requests","openapi":"POST /v1/field-requests","href":"/api-reference/field-requests"},{"title":"GET /v1/field-requests/{request_id}","openapi":"GET /v1/field-requests/{request_id}","href":"/api-reference/field-requests-status"}]},{"group":"Reference","pages":[{"title":"Errors","href":"/api-reference/errors"},{"title":"Agent onboarding API","href":"/api-reference/agent-onboarding"}]},{"group":"Migration","pages":[{"title":"Lookup and Resolve migration","href":"/api-reference/lookup"},{"title":"Fetch quote compatibility","href":"/api-reference/fetch-quote"}]}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/mcp/installation"}]}]},"basePath":"","title":"POST /v1/search - Mireye","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}