Jurisdictions children
Exactjurisdictions_childrenDeterministic and authoritative — the canonical answer for this input.
List all child jurisdictions of a parent code. E.g. parent_code='US' returns all 59 US states, territories, DC, and armed-forces postal codes. Returns items sorted by type then code, with count and is_valid: a KNOWN code with no children answers is_valid true / count 0 at full confidence, while an unrecognized code answers is_valid false with why_invalid. Processing multiple inputs? Use `jurisdictions_children_batch` to do up to 100 in one call.
Parameters
parent_codestringrequiredParent jurisdiction code (e.g. 'US' to get all US children).
Call it
curl -X POST https://api.snipget.ai/v1/jurisdictions/children \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"parent_code":"US"}'The Batch tab sends up to 1000 inputs in one call via /v1/jurisdictions/children/batch.
FAQ
What is this for?
It returns everything that lives under a parent jurisdiction. parent_code US gives you all 59 US children: the 50 states, the territories, DC, and the armed-forces postal codes, in one call.
How is this different from List jurisdictions?
List gives you everything of one type (e.g. all countries). Children gives you everything under one parent regardless of type (e.g. states, territories, and DC together, all under US). Use Children when you care about the parent, use List when you care about the type.
Is the result exact?
Yes, it is deterministic against the maintained reference data. A parent with children returns confidence 1.0 and a count you can verify against.
Which parents have children?
Today the hierarchy is US and its subdivisions. Most countries are top-level and have no children, so asking for their children is valid but returns an empty set.
What happens for a parent with nothing under it?
A known code like JP answers with an empty list, count 0, is_valid true, and full confidence: the place is real and simply has no children. A code that is not a jurisdiction at all answers is_valid false with a why_invalid reason at confidence 0, so you can tell the two apart.