--- updatedAt: 2026-07-16T19:38:26.000Z agentTools: projectIndex: https://support.regrid.com/llms.txt --- # Assessor Parcel Number (APN) Search This endpoint delivers parcels using the Assessor Parcel Number (APN) which is assigned to each parcel by the respective admin2. Multiple parcels can be returned depending on the APN, therefore specify the location within an admin1, admin2 admin3 by using the parameter `path`. **Attention API Trial Token Users:** Data is restricted to 7 counties. Please only use data from one of the restricted counties. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Regrid OpenAPI Specification", "version": "2.0.1", "description": "Integrate Regrid's parcel data in your tech stack with over 156M parcels records with associated spatial and tabular data including over 120 fields." }, "externalDocs": { "description": "Regrid Parcel documentation and extended examples", "url": "https://support.regrid.com/api" }, "servers": [ { "url": "https://app.regrid.com/api/v2", "description": "Regrid API server" } ], "security": [ { "APIKeyHeader": [] }, { "APIKeyQueryParam": [] } ], "paths": { "/ca/parcels/apn": { "get": { "tags": [ "Canada" ], "summary": "Assessor Parcel Number (APN) Search", "description": "This endpoint delivers parcels using the Assessor Parcel Number (APN) which is assigned to each parcel by the respective admin2. Multiple parcels can be returned depending on the APN, therefore specify the location within an admin1, admin2 admin3 by using the parameter `path`. **Attention API Trial Token Users:** Data is restricted to 7 counties. Please only use data from one of the restricted counties.", "parameters": [ { "name": "parcelnumb", "in": "query", "schema": { "type": "integer", "description": "The assessor's parcel number to look up. Non-alphanumeric characters will be removed when searching." }, "required": true, "example": "96376" }, { "$ref": "#/components/parameters/canadaPathParam" }, { "$ref": "#/components/parameters/limitParam" }, { "$ref": "#/components/parameters/returnCustom" }, { "$ref": "#/components/parameters/returnFieldLabels" }, { "$ref": "#/components/parameters/returnStacked" } ], "responses": { "200": { "description": "A list of parcel features.", "content": { "application/json": { "schema": { "allOf": [ { "$ref": "#/components/schemas/SimpleResponse" } ] } } } }, "401": { "$ref": "#/components/responses/Unauthorized" } } } } }, "components": { "securitySchemes": { "APIKeyHeader": { "name": "x-regrid-token", "description": "Your Regrid authorization token", "type": "apiKey", "in": "header" }, "APIKeyQueryParam": { "name": "token", "description": "Your Regrid authorization token", "type": "apiKey", "in": "query" } }, "schemas": { "SimpleResponse": { "properties": { "parcels": { "type": "object", "properties": { "type": { "type": "string", "example": "FeatureCollection" }, "features": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "example": "Feature" }, "geometry": { "allOf": [ { "nullable": true }, { "anyOf": [ { "$ref": "#/components/schemas/Polygon" }, { "$ref": "#/components/schemas/MultiPolygon" } ] } ] }, "properties": { "type": "object", "properties": { "headline": { "type": "string", "description": "A human-friendly display address for the parcel. If no address is available, it falls back to the parcel number." }, "path": { "type": "string", "description": "The parcel's unique identifier" }, "fields": { "type": "object", "description": "Standard Schema keys and values. Columns from the parcel table. These include standard column names wherever fields are available, plus additional columns varying by the particular county & data available." }, "field_labels": { "type": "object", "description": "Human-friendly labels for each key in fields" }, "context": { "type": "object", "description": "A bit of info about the city or county where this parcel is found, including a path one can use as context for further searches." }, "ll_uuid": { "type": "string" } } }, "ll_uuid": { "type": "string" } } } } } } } }, "GeoJsonObject": { "description": "GeoJSon object\nThe coordinate reference system for all GeoJSON coordinates is a geographic coordinate reference system, using the World Geodetic System 1984 (WGS 84) datum, with longitude and latitude units of decimal degrees. This is equivalent to the coordinate reference system identified by the Open Geospatial Consortium (OGC) URN An OPTIONAL third-position element SHALL be the height in meters above or below the WGS 84 reference ellipsoid. In the absence of elevation values, applications sensitive to height or depth SHOULD interpret positions as being at local ground or sea level.\n", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3" }, "type": "object", "properties": { "type": { "type": "string", "enum": [ "Feature", "FeatureCollection", "Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon", "GeometryCollection" ] }, "bbox": { "type": "array", "items": { "type": "number" } } }, "required": [ "type" ], "discriminator": { "propertyName": "type" } }, "Geometry": { "description": "Abstract type for all GeoJSon object except Feature and FeatureCollection\n", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3" }, "allOf": [ { "$ref": "#/components/schemas/GeoJsonObject" }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon", "GeometryCollection" ] } }, "required": [ "type" ], "discriminator": { "propertyName": "type" } } ] }, "GeometryElement": { "description": "Abstract type for all GeoJSon 'Geometry' object the type of which is not 'GeometryCollection'\n", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3" }, "allOf": [ { "$ref": "#/components/schemas/Geometry" }, { "type": "object", "properties": { "type": { "type": "string", "enum": [ "Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon" ] } }, "required": [ "type" ], "discriminator": { "propertyName": "type" } } ] }, "Feature": { "description": "GeoJSon 'Feature' object", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.2" }, "allOf": [ { "$ref": "#/components/schemas/GeoJsonObject" }, { "type": "object", "required": [ "geometry", "properties" ], "properties": { "geometry": { "allOf": [ { "nullable": true }, { "$ref": "#/components/schemas/Geometry" } ] }, "properties": { "type": "object", "nullable": true }, "id": { "oneOf": [ { "type": "number" }, { "type": "string" } ] } } } ] }, "FeatureCollection": { "description": "GeoJSon 'FeatureCollection' object", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.3" }, "allOf": [ { "$ref": "#/components/schemas/GeoJsonObject" }, { "type": "object", "required": [ "features" ], "properties": { "features": { "type": "array", "items": { "$ref": "#/components/schemas/Feature" } } } } ] }, "Position": { "description": "GeoJSon fundamental geometry construct.\nA position is an array of numbers. There MUST be two or more elements. The first two elements are longitude and latitude, or easting and northing, precisely in that order and using decimal numbers. Altitude or elevation MAY be included as an optional third element.\nImplementations SHOULD NOT extend positions beyond three elements because the semantics of extra elements are unspecified and ambiguous. Historically, some implementations have used a fourth element to carry a linear referencing measure (sometimes denoted as \"M\") or a numerical timestamp, but in most situations a parser will not be able to properly interpret these values. The interpretation and meaning of additional elements is beyond the scope of this specification, and additional elements MAY be ignored by parsers.\n", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.1.1" }, "type": "array", "minItems": 2, "maxItems": 3, "items": { "type": "number" } }, "LinearRing": { "description": "A linear ring is a closed LineString with four or more positions.\nThe first and last positions are equivalent, and they MUST contain identical values; their representation SHOULD also be identical.\nA linear ring is the boundary of a surface or the boundary of a hole in a surface.\nA linear ring MUST follow the right-hand rule with respect to the area it bounds, i.e., exterior rings are counterclockwise, and holes are clockwise.\n", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.1.6" }, "type": "array", "items": { "$ref": "#/components/schemas/Position" }, "minItems": 4 }, "Polygon": { "description": "GeoJSon geometry", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.1.6" }, "allOf": [ { "$ref": "#/components/schemas/GeometryElement" }, { "type": "object", "required": [ "coordinates" ], "properties": { "coordinates": { "type": "array", "items": { "$ref": "#/components/schemas/LinearRing" } } } } ] }, "MultiPolygon": { "description": "GeoJSon geometry", "externalDocs": { "url": "https://tools.ietf.org/html/rfc7946#section-3.1.7" }, "allOf": [ { "$ref": "#/components/schemas/GeometryElement" }, { "type": "object", "required": [ "coordinates" ], "properties": { "coordinates": { "type": "array", "items": { "type": "array", "items": { "$ref": "#/components/schemas/LinearRing" } } } } } ] } }, "responses": { "Unauthorized": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "example": "error" }, "message": { "type": "string", "example": "An access token is required." } } } } } } }, "parameters": { "limitParam": { "name": "limit", "in": "query", "description": "Maximum number of Parcel Records to return.", "required": false, "schema": { "type": "integer" }, "example": 5 }, "returnCustom": { "name": "return_custom", "in": "query", "description": "Default false: A true value allows county-specific fields to be passed through beyond standard schema fields only.", "required": false, "schema": { "type": "boolean" } }, "returnFieldLabels": { "name": "return_field_labels", "in": "query", "description": "Default false: A true value shows the naming convention for each standardized schema field.", "schema": { "type": "boolean" } }, "returnStacked": { "name": "return_stacked", "in": "query", "schema": { "type": "boolean" }, "description": "Default true: A false value returns the first parcel if geometries are identical." }, "canadaPathParam": { "name": "path", "in": "query", "schema": { "type": "string" }, "description": "Represents the path for the /admin0/admin1/admin2. This restricts the search to this area.", "example": "/ca/mb/division-no-22" } } } } ```