Countries
Access to countries is provided to all users who have the appropriate permission in their personal account.
For getting information about countries, the following requests are provided:
The list method allows you to get a list of the countries
Request:
{site_path}/{lang}/api/country/list
GET parameters list:
| filter | array | Allows filtering data by all available fields |
| fields | string | Allows to select only the specified fields from all available |
| sort | string | Allows you to sort asc and desc entities by all available fields |
| page | int | Allows you to pass the page number of the list of entities |
List of all available fields
| id | int | ID Country |
| name | string | Country name |
| c2 | string | International country code (C2) |
| c3 | string | International country code (C3) |
| aloc | string | aloc |
Response
The response is transmitted in JSON format. List of response fields:
| result | array | List of countries based on query parameters |
| _links | array | List of navigation links. May contain the following elements:
|
| _meta | array | Information on list navigation. Contains elements:
|
Request example:
{site_path}/{lang}/api/country/list?filter[id][in][]=1&filter[id][in][]=2&filter[id][in][]=3&sort=name
Response example:
{
"result": [
{
"id": 2,
"name": "Australia",
"c2": "AU",
"c3": "AUS",
"aloc": "apnic"
},
{
"id": 3,
"name": "China",
"c2": "CN",
"c3": "CHN",
"aloc": "apnic"
}
],
"_links": {
"self": {
"href": "{site_path}/{lang}/api/country/list?%3Ffilter%5Bid%5D%5Bin%5D%5B0%5D=1&filter%5Bid%5D%5Bin%5D%5B0%5D=2&filter%5Bid%5D%5Bin%5D%5B1%5D=3&sort=name&page=1"
}
},
"_meta": {
"totalCount": 2,
"pageCount": 1,
"currentPage": 1,
"perPage": 20
}
}