GET
/
jurisdictions
/
search
Search Jurisdictions
curl --request GET \
  --url https://api.shovels.ai/v2/jurisdictions/search \
  --header 'X-API-Key: <api-key>'
{
  "items": [
    {
      "geo_id": "Q2l0eV8xMjM0NQ",
      "name": "Sanford, FL",
      "state": "FL"
    },
    {
      "geo_id": "A2l0eV8xMjM0NQ",
      "name": "Abilene, TX",
      "state": "TX"
    },
    {
      "geo_id": "B2l0eV8xMjM0NQ",
      "name": "Albany, CA",
      "state": "CA"
    }
  ],
  "page": 1,
  "size": 3
}

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string
required

The name to search for in the jurisdiction fields.

Response

A list of jurisdictions that match the search text.

Generic paginated response for geographical entities.

items
GeoEntitiesRead · object[]
required

The list of items returned in the response following given criteria.

page
integer
required

The page number of the response.

size
integer
required

The number of items returned in the response.

next_page
integer | null
required

The next page number of the response.