get
/api/v2/zones/by-ids/{id}
Python SDK method:
client.zones.by_ids(id=job_id).results()

Get zones by IDs results

Returns paginated GeoJSON zone features for a completed get zones data job. Each feature contains zone polygon geometry and ZoneMetadata properties.

Altitude Help Center — getZonesData

Input Parameters

NameLocationTypeValuesDescriptionValue Required
idpathstring-The id of the job whose results you want to fetch.Y

Success Responses

200 response: object

Paginated result data. When more pages are available, a Link: rel="next" header and Altitude-* pagination headers are included in the response.

NameTypeDescription
bboxarray<number (double)>Bounding box [west, south, east, north].
geometryobjectGeoJSON geometry object representing the zone boundary.
propertiesobjectZone metadata object containing the zone's identity, type, display name, and type-specific details.
typestringAlways "Feature".

Response Errors

HTTP Status CodeReason
400The request body or parameters are invalid.
401Authentication is required or the provided credentials are invalid.
403The authenticated user lacks permission to perform this operation.
404The requested resource does not exist.
409Result not yet ready. Poll the status monitor.
429The request rate limit has been exceeded.
500An unexpected server error occurred.