geo_contains
Walk containment and return descendants at one requested level.
Description
Walk containment and return descendants at one requested level.
Children are ordered by stable geography_id; each carries level,
official code/name, country/state, row as_of, source, and attribution.
The default page is 50 and maximum is 200. Pass next_cursor back until
has_more is false. An unknown ID returns unknown_entity; an
incompatible country/level returns bad_parameter.
Example: geo_contains(geography_id="state_48", child_level="county", limit=50).
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| geography_id | string | Yes | — | — | Exact stable geography_id returned by geo_resolve. |
| child_level | "nation" | "state" | "county" | "cbsa" | "zip3" | "zcta" | "au_state" | "au_gccsa" | "au_sa4" | "au_sa3" | "au_lga" | Yes | — | — | Descendant level to return, such as county for a US state or au_sa4 for an Australian GCCSA. |
| limit | integer | No | 50 | min 1, max 200 | Descendants per page (1–200). |
| cursor | string | null | No | null | — | Opaque cursor from pagination.next_cursor. Keep geography_id and child_level constant while paging; omit for the first page. |
Provenance
Sources behind every value this tool returns.
- abs_asgsAustralian Bureau of Statistics
- census_geoU.S. Census Bureau
- census_rel2020U.S. Census Bureau
- omb_delineation_2023Office of Management and Budget (delineation lists distributed via the U.S. Census Bureau)
Dataset registry: geo_au_asgs, geo_us_reference