--- title: List Geolocations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [Geolocations](https://developers.cloudflare.com/api/go/resources/radar/subresources/geolocations) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Geolocations client.Radar.Geolocations.List(ctx, query) (\*[GeolocationListResponse](), error) 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` ##### ParametersExpand Collapse
query GeolocationListParams
Format param.Field\[GeolocationListParamsFormat]Optional Format in which results will be returned. const GeolocationListParamsFormatJson GeolocationListParamsFormat = "JSON" Link to this property const GeolocationListParamsFormatCsv GeolocationListParamsFormat = "CSV" Link to this property
Link to this property GeoID param.Field\[string]Optional Filters results by geolocation. Specify a comma-separated list of GeoNames IDs. Link to this property Limit param.Field\[int64]Optional Limits the number of objects returned in the response. exclusiveMinimum minimum0 Link to this property Location param.Field\[string]Optional Filters results by location. Specify a comma-separated list of alpha-2 location codes. Link to this property Offset param.Field\[int64]Optional Skips the specified number of objects before fetching the results. minimum0 Link to this property
[Link to this property](<#(resource)%20radar.geolocations%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type GeolocationListResponse struct{…}
Geolocations \[]GeolocationListResponseGeolocation 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 GeolocationListResponseGeolocationsParent 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 GeolocationListResponseGeolocationsParentParent 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 GeolocationListResponseGeolocationsParentParentType The type of the geolocation. One of the following: const GeolocationListResponseGeolocationsParentParentTypeContinent GeolocationListResponseGeolocationsParentParentType = "CONTINENT" Link to this property const GeolocationListResponseGeolocationsParentParentTypeCountry GeolocationListResponseGeolocationsParentParentType = "COUNTRY" Link to this property const GeolocationListResponseGeolocationsParentParentTypeAdm1 GeolocationListResponseGeolocationsParentParentType = "ADM1" Link to this property
Link to this property Code stringOptional Link to this property Locale stringOptional BCP 47 locale code used for the geolocation name translation Link to this property
Link to this property
Type GeolocationListResponseGeolocationsParentType The type of the geolocation. One of the following: const GeolocationListResponseGeolocationsParentTypeContinent GeolocationListResponseGeolocationsParentType = "CONTINENT" Link to this property const GeolocationListResponseGeolocationsParentTypeCountry GeolocationListResponseGeolocationsParentType = "COUNTRY" Link to this property const GeolocationListResponseGeolocationsParentTypeAdm1 GeolocationListResponseGeolocationsParentType = "ADM1" Link to this property
Link to this property Code stringOptional Link to this property Locale stringOptional BCP 47 locale code used for the geolocation name translation Link to this property
Link to this property
Type GeolocationListResponseGeolocationsType The type of the geolocation. One of the following: const GeolocationListResponseGeolocationsTypeContinent GeolocationListResponseGeolocationsType = "CONTINENT" Link to this property const GeolocationListResponseGeolocationsTypeCountry GeolocationListResponseGeolocationsType = "COUNTRY" Link to this property const GeolocationListResponseGeolocationsTypeAdm1 GeolocationListResponseGeolocationsType = "ADM1" Link to this property
Link to this property Code stringOptional Link to this property Locale stringOptional 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(model)%20GeolocationListResponse%20%3E%20(schema)>) ### List Geolocations Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) geolocations, err := client.Radar.Geolocations.List(context.TODO(), radar.GeolocationListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", geolocations.Geolocations) } ``` 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 } ```