GET /geo/place/{id}

Returns structured data for a single place by its numeric ID. IDs are returned by /geo/resolve and /geo/search.

Costs 1 credit per request.

Request

GET /geo/place/{id}
Authorization: Bearer gaz_<api-key>

Path Parameters

Parameter	Type	Description
`id`	integer	Numeric place ID

Response

{
  "id": 3457419,
  "name": "Mato Grosso",
  "type": "state",
  "lat": -12.5,
  "lon": -55.5,
  "population": 3526220,
  "parent": {
    "id": 3469034,
    "name": "Brazil",
    "type": "country"
  }
}

Fields

Field	Type	Description
`id`	integer	Unique place identifier
`name`	string	Official place name
`type`	string	`world` \| `country` \| `state` \| `city`
`lat`	float \| null	Latitude
`lon`	float \| null	Longitude
`population`	integer	Population count
`parent`	object \| null	Direct parent in the hierarchy (`null` for the world root)

Error Responses

Status	Description
`401`	Missing or invalid API key
`402`	Insufficient credits
`404`	Place ID not found
`429`	Rate limit exceeded

Example

curl https://api.gazetteer.dev/geo/place/3469034 \
  -H "Authorization: Bearer gaz_..."

{
  "id": 3469034,
  "name": "Brazil",
  "type": "country",
  "lat": -10.0,
  "lon": -55.0,
  "population": 214300000,
  "parent": {
    "id": 1,
    "name": "World",
    "type": "world"
  }
}