Filter countries.
Sample request:
GET /countries?code=FR&offset=0&limit=5
or
GET /countries?code=AD,FR&offset=0&limit=5
If you want to search for multiple values for a given parameter, enter :
param=val1,val2
For example, the query shown above would return the countries that have a code being either AD
or FR
.
Query parameters
-
Country code to search for.
Default value is empty.
-
Country name to search for.
Default value is empty.
-
Country identifier to search for.
Default value is empty.
-
Boolean that indicates the sort order. If it is set to true, results will be sorted by descending order.
Default value is
false
. -
Index of the first returned result.
Default value is
0
. -
Number of results to be returned. Max value is 10.
Default value is
10
.
GET
/countries
curl \
-X GET https://soget-api-integration.azure-api.net/api-referential-list/v1/countries \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Ocp-Apim-Subscription-Key: $API_KEY"
Response examples (200)
{
"total": 11,
"first": 3,
"items": [
{
"name": "France",
"alphaCode2": "FR",
"alphaCode3": "FRA",
"identifier": 250
}
]
}
Response examples (400)
{
"status": "400",
"timestamp": "2022-10-18T14:53:52.239Z",
"code": "R001",
"message": "Information not found."
}