--- title: Get a List of Geo Locations framework: Apple Ads role: symbol role_heading: Web Service Endpoint platforms: [search ads 5.0+] path: apple_ads/get-a-list-of-geo-locations --- # Get a List of Geo Locations Gets geolocation details using a geoidentifier. ## URL POST https://api.searchads.apple.com/api/v5/search/geo ## Query Parameters limit: The limit on the number of geolocations in the response. POST https://api.searchads.apple.com/api/v5/search/geo?limit=100 offset: The offset pagination that limits the number of returned records. The start of each page is offset by the specified number. You can apply offset to most API calls, but not all GET endpoints support it. POST https://api.searchads.apple.com/api/v5/search/geo?offset= ## Response Codes 200 OK: If the call succeeds, the API returns a list of SearchEntity objects in the response payload with an HTTP status code of 200(OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 400 Bad Request: An invalid query or missing required parameters. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 404 Not Found: The API can’t locate the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later. ## Discussion Discussion Use a geo id in the request payload to return a corresponding displayName and geolocation. Payload Example: Get a list of geolocations ## HTTP Body The georequest body. ## See Also ### Search Geolocation Endpoints - [Search for Geolocations](apple_ads/search-for-geolocations.md)