---
title: "Typeahead"
method: GET
path: "/parcels/typeahead"
tags: ["Address Typeahead"]
---

# Typeahead

`GET /parcels/typeahead`

This endpoint delivers a full address lookup and validation with corresponding unique identifier for each parcel based on matching the query. This is a Regrid Enterprise product. **Attention API Trial Token Users:** Data is restricted to 7 counties. Please only use data from one of the restricted counties.

## Query parameters

- `query` string, required

## Response `200`

A list of parcel features. When supported by the account with buildings array and addresses property

- TypeaheadCentroidResponse
  - `parcel_centroids` object
    - `type` string
    - `features` object[]
      - `type` string
      - `geometry` union
        - object, nullable — GeoJSon object The 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.
          - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon', required
          - `bbox` number[]
          - `coordinates` LinearRing[], required
            - Position[] — A linear ring is a closed LineString with four or more positions. The first and last positions are equivalent, and they MUST contain identical values; their representation SHOULD also be identical. A linear ring is the boundary of a surface or the boundary of a hole in a surface. A 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.
              - …
        - object, nullable — GeoJSon object The 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.
          - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon', required
          - `bbox` number[]
          - `coordinates` array[], required
            - LinearRing[]
              - …
      - `properties` object
        - `ll_uuid` string
        - `score` number
        - `context` object — 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.
        - `path` string — The parcel's unique identifier
        - `address` string — 123 E Some Street
      - `id` integer

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/regrid/apis/regrid-openapi-specification.md) · [All operations](https://skmtc.dev/regrid/apis/regrid-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/regrid/regrid-openapi-specification/revisions/e4abb9a7fcfe/schema)