Jurisdictions lookup

Exact

jurisdictions_lookup

Deterministic and authoritative — the canonical answer for this input.

Look up a jurisdiction by its code. Returns the full canonical record (code, name, iso_code, type, parent_code, matched_by). When the code is ambiguous (22 codes overlap between countries and US states), supply type and/or parent_code to disambiguate. Without filters, US-scoped types are preferred. Processing multiple inputs? Use `jurisdictions_lookup_batch` to do up to 1000 in one call.

Parameters

codestringrequired

Jurisdiction code to look up (e.g. 'US', 'CA', 'GB').

typestringoptional

Filter by jurisdiction type. Valid values: country, state, territory, district, armed_forces_postal. When omitted, all types are searched and the best match is returned (US-scoped types preferred when ambiguous).

parent_codestringoptional

Filter by parent code (e.g. 'US' to restrict to US states/territories/DC). Case-insensitive.

Call it

curl -X POST https://api.snipget.ai/v1/jurisdictions/lookup \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"code":"US"}'

The Batch tab sends up to 1000 inputs in one call via /v1/jurisdictions/lookup/batch.

Example response

{
  "code": "US",
  "name": "United States",
  "iso_code": "US",
  "type": "country",
  "parent_code": null,
  "matched_by": "code"
}

FAQ

When should I use Look up instead of Normalize?

Use Look up when you already have a clean code (like US, CA, GB) and just want the full record. Normalize is the one to use when your input might be a full name or messy, since Look up only matches on code.

How do I handle a code that means two places?

CA is both California and Canada. Add type as country or parent_code as US to disambiguate. Without a filter you get the best match by US-first priority at confidence 0.85, so you always know when it was ambiguous.

Is the result authoritative?

Yes, it is exact and deterministic against the bundled reference list, not a model guess. A single clean match is confidence 1.0.

What is in the record?

code, name, iso_code (the ISO 3166 code, null for armed-forces codes), type, parent_code (the parent like US, or null for countries), and matched_by.

What if the code is not real?

You get confidence 0 with all fields null and a reason, not an error. The same goes for a code that exists but not under the type or parent you asked for.

Full API reference (schemas, error codes) →