jurisdictions

Validate a jurisdiction code or name

Check whether a value is a recognized jurisdiction. Returns is_valid (bool), type, and matched_by. Use normalize or lookup for the full canonical record. Accepts codes (case-insensitive), full names, and curated common variants like 'USA'/'UK' (matched_by='alias'). Filter by type and/or parent_code to disambiguate collisions (e.g. CA = California vs Canada).

post/v1/jurisdictions/validate

Request

  • Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.snipget.ai/v1/jurisdictions/validate
  • Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable
X-API-Keystring nullable

Request body

valuestring required

Jurisdiction code or full name to validate.

typestring nullable

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_codestring nullable

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

include_traceboolean

Response

Successful Response

statusstring
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.