---
title: Get Geolocation details
---
[Skip to content](#_top)
[API Reference](https://developers.cloudflare.com/api)
[Radar](https://developers.cloudflare.com/api/resources/radar)
[Geolocations](https://developers.cloudflare.com/api/resources/radar/subresources/geolocations)
Copy Markdown
Open in **Claude**Open in **ChatGPT**Open in **Cursor**
---
**Copy Markdown****View as Markdown**
# Get Geolocation details
GET/radar/geolocations/{geo\_id}
Retrieves the requested Geolocation information. Geolocation names can be localized by sending an `Accept-Language` HTTP header with a BCP 47 language tag (e.g., `Accept-Language: pt-PT`). The full quality-value chain is supported (e.g., `pt-PT,pt;q=0.9,en;q=0.8`).
##### Security
API Token
The preferred authorization scheme for interacting with the Cloudflare API. Create a token.
**Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key
The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.
**Example:**X-Auth-Email: user@example.com
The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.
**Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required)
`User Details Write``User Details Read`
##### P ath ParametersExpand Collapse
geo\_id: string
Geolocation ID. Refer to [GeoNames](https://download.geonames.org/export/dump/readme.txt)
maxLength100
[Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20geo_id%20%3E%20(schema)>)
##### Q uery ParametersExpand Collapse
format: optional "JSON"or "CSV"
Format in which results will be returned.
One of the following:
"JSON"
Link to this property
"CSV"
Link to this property
[Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20get%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>)
##### ReturnsExpand Collapse
result: object {geolocation }
geolocation: object {geoId, latitude, longitude, 5 more }
geoId: string
Link to this property
latitude: string
A numeric string.
Link to this property
longitude: string
A numeric string.
Link to this property
name: string
Link to this property
parent: object {geoId, latitude, longitude, 5 more }
geoId: string
Link to this property
latitude: string
A numeric string.
Link to this property
longitude: string
A numeric string.
Link to this property
name: string
Link to this property
parent: object {geoId, latitude, longitude, 4 more }
geoId: string
Link to this property
latitude: string
A numeric string.
Link to this property
longitude: string
A numeric string.
Link to this property
name: string
Link to this property
type: "CONTINENT"or "COUNTRY"or "ADM1"
The type of the geolocation.
One of the following:
"CONTINENT"
Link to this property
"COUNTRY"
Link to this property
"ADM1"
Link to this property
Link to this property
code: optional string
Link to this property
locale: optional string
BCP 47 locale code used for the geolocation name translation
Link to this property
Link to this property
type: "CONTINENT"or "COUNTRY"or "ADM1"
The type of the geolocation.
One of the following:
"CONTINENT"
Link to this property
"COUNTRY"
Link to this property
"ADM1"
Link to this property
Link to this property
code: optional string
Link to this property
locale: optional string
BCP 47 locale code used for the geolocation name translation
Link to this property
Link to this property
type: "CONTINENT"or "COUNTRY"or "ADM1"
The type of the geolocation.
One of the following:
"CONTINENT"
Link to this property
"COUNTRY"
Link to this property
"ADM1"
Link to this property
Link to this property
code: optional string
Link to this property
locale: optional string
BCP 47 locale code used for the geolocation name translation
Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>)
success: boolean
[Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20success>)
### Get Geolocation details
HTTP
HTTPTypeScriptPythonGoTerraform
```
curl https://api.cloudflare.com/client/v4/radar/geolocations/$GEO_ID \
-H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```
200 example
```
{
"result": {
"geolocation": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"parent": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"parent": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
},
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
},
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
}
},
"success": true
}
```
##### Returns Examples
200 example
```
{
"result": {
"geolocation": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"parent": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"parent": {
"geoId": "2267056",
"latitude": "10",
"longitude": "10",
"name": "Lisbon",
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
},
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
},
"type": "CONTINENT",
"code": "PT-11",
"locale": "pt-PT"
}
},
"success": true
}
```