--- title: List Geolocations --- [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** # List Geolocations GET/radar/geolocations Retrieves a list of geolocations. 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` ##### 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)%20list%20%3E%20(params)%20default%20%3E%20(param)%20format%20%3E%20(schema)>) geoId: optional string Filters results by geolocation. Specify a comma-separated list of GeoNames IDs. [Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20geoId%20%3E%20(schema)>) limit: optional number Limits the number of objects returned in the response. exclusiveMinimum minimum0 [Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20limit%20%3E%20(schema)>) location: optional string Filters results by location. Specify a comma-separated list of alpha-2 location codes. [Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20location%20%3E%20(schema)>) offset: optional number Skips the specified number of objects before fetching the results. minimum0 [Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20offset%20%3E%20(schema)>) ##### ReturnsExpand Collapse
result: object {geolocations }
geolocations: array of 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)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) success: boolean [Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>) ### List Geolocations HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/radar/geolocations \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 200 example ``` { "result": { "geolocations": [ { "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": { "geolocations": [ { "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 } ```