Skip to main content
GET
Search States

Authorizations

X-API-Key
string
header
required

Query Parameters

q
string
required

The name to search for in the state fields.

cursor
string | null

Continuation cursor containing the match rank and state ID.

size
integer
default:50
Required range: 1 <= x <= 100

Response

A list of states that match the search term.

Paginated response for states.

items
States · object[]
required

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

size
integer
required

The number of items returned in the response.

next_cursor
string | null
required

The cursor for retrieving the next page of results.

total_count
TotalCount · object | null

Top-level count object, not an integer: {"value": 970, "relation": "eq"}. "eq" means an exact count up to 10,000. "gte" means at least 10,000 matches, with value set to 10,000. Counted only when requested on the first page without a cursor. null when not requested, on later pages, or when the count query times out.

Example: