List of Regions
GET {{location_url}}/regions?countryId=1&offset=0&sortOrder=asc
Retrieve a list of regions
You can retrieve all of the regions (e.g., provinces, regions) available for geo targeting by sending this GET
request.
The region id
s returned in the response body can be used to define fields within the following Campaign Service requests:
-
POST
New LI -geography
(DTO)
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
countryId | number | Limits response results to regions in the country specified. |
Value can be retrieved from GET List of Countries. |
| offset
| number | | The starting index in the list of regions. |
| limit
| number | | The number of regions to return. |
| sortOrder
| string | | Direction of result sorting (by name).
Allowed values: asc, desc |
RESPONSES
status: OK
{"totalNum":13,"data":[{"id":"1","resourceType":"region","name":"Alberta","countryId":"1"},{"id":"2","resourceType":"region","name":"British Columbia","countryId":"1"},{"id":"3","resourceType":"region","name":"Manitoba","countryId":"1"},{"id":"4","resourceType":"region","name":"New Brunswick","countryId":"1"},{"id":"5","resourceType":"region","name":"Newfoundland","countryId":"1"},{"id":"12","resourceType":"region","name":"Northwest Territories","countryId":"1"},{"id":"6","resourceType":"region","name":"Nova Scotia","countryId":"1"},{"id":"7","resourceType":"region","name":"Nunavut","countryId":"1"},{"id":"8","resourceType":"region","name":"Ontario","countryId":"1"},{"id":"9","resourceType":"region","name":"Prince Edward Island","countryId":"1"},{"id":"10","resourceType":"region","name":"Quebec","countryId":"1"},{"id":"11","resourceType":"region","name":"Saskatchewan","countryId":"1"},{"id":"13","resourceType":"region","name":"Yukon Territory","countryId":"1"}],"errors":[],"links":{"self":"https://services.amobee.com/location/v1/api/regions?countryId=1\u0026offset=0\u0026sortOrder=asc"}}