Actions7
Walk Up Admin Chain
AI-generatedSummary
Retrieve the ancestral administrative divisions of a specified geographic division by walking up the parent division chain to the country level.
Inputs
- Division ID (required) — Overture ID of the division to start the ancestor walk from (this ID can be obtained from the Postcode → Boundary operation).
- Boundary Options — Optional settings to customize the response, including whether to include the polygon geometry as GeoJSON, the polygon precision level (low, med, full), maximum depth for ancestor retrieval (1-12), language for division names using BCP-47 tags, and whether to include a full translations map under other_names.
Output shape
A list of ancestor divisions, each represented as a separate item in the output array, ordered from the starting division (depth 0) up to the root division (typically the country). Each item includes division metadata such as ID, name, subtype, country, region, population, Wikidata identifier, parent division ID, and optionally bounding box and geometry fields.
The maximum ancestor depth can be capped via the Max Depth parameter (default 8, range 1-12). Including geometry or other language translations is optional via boundary options. Errors per input item produce error JSON if continueOnFail is enabled; otherwise, execution stops on failure.
Examples
Example 1: Walk up the administrative chain for a division given its Division ID, including geometry data with medium precision and French language names.
Set Division ID to the target division's Overture ID, enable Include Geometry, set Polygon Precision to 'Med', and Language to 'fr'.