--- updatedAt: 2026-07-16T19:38:04.000Z agentTools: projectIndex: https://support.regrid.com/llms.txt --- # Regrid ID This endpoint delivers a single parcel record based on the Regrid id (ll_uuid). Note: the example shown uses Canada (`ca`). # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Regrid Global OpenAPI Specification", "version": "2.0.1", "description": "Regrid's international parcel API. Access parcel data outside the US using ISO 3166-1 alpha-2 country codes." }, "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": { "/{country}/parcels/{ll_uuid}": { "get": { "tags": [ "International" ], "summary": "Regrid ID", "description": "This endpoint delivers a single parcel record based on the Regrid id (ll_uuid). Note: the example shown uses Canada (`ca`).", "parameters": [ { "$ref": "#/components/parameters/countryParam" }, { "name": "ll_uuid", "in": "path", "schema": { "type": "string" }, "description": "The UUID retrieved from another Regrid API call", "required": true, "example": "ca62ba61-d0c6-4a83-83ad-02d635a77c26" }, { "$ref": "#/components/parameters/returnCustom" }, { "$ref": "#/components/parameters/returnFieldLabels" }, { "$ref": "#/components/parameters/returnStacked" } ], "responses": { "200": { "description": "A list of parcel features. 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": { "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. Note: only supported for Canada (`ca`).", "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." }, "countryParam": { "name": "country", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "ca", "ch", "cy", "cz", "de", "dk", "ee", "es", "fi", "fr", "gb", "ie", "is", "it", "lu", "lv", "nl", "no", "pl", "si", "sk" ] }, "description": "ISO 3166-1 alpha-2 country code for international data.", "example": "ca, fr, sk" } } } } ```