Get Countries
GET
/api/v1/public/shared/countries
Lists countries with pagination. No token required.
Parameters
Header Parameters
Accept-Language
Language of country and unit of measure names and validation error messages. English when it starts with en (e.g. en, en-US), Turkish otherwise. Success messages are always in Turkish.
Typestring
Examples
"tr""en"Default
"tr"Query Parameters
page
Page number
Typeinteger
Minimum
1Default
1perPage
Records per page. To get the whole list, use 200 and iterate over meta.pageCount pages.
Typeinteger
Minimum
1Maximum
200Default
50sortBy
Sort field. name sorts by the English name; orderNumber and isGuarantee are not returned in the response. Ties are sorted by id.
Typestring
Valid values
"orderNumber""name""code""id""isGuarantee"Default
"orderNumber"sortOrder
Sort direction (case-insensitive)
Typestring
Valid values
"asc""desc"Default
"desc"id
Country ID
Typeinteger
Example
234Minimum
1code
Country code (exact match, case-insensitive)
Typestring
Example
"TR"Min Length
1Max Length
8search
Countries whose ID equals this value or whose English or Turkish name or code contains it
Typestring
Example
"TURK"Min Length
1Max Length
255isGuarantee
Filters countries covered by the guarantee
Typeboolean
Responses
Countries listed
application/json
JSON
{
"success": true,
"message": "Ülkeler listelendi",
"items": [
{
"id": 234,
"code": "TR",
"name": "Turkiye",
"phoneCode": "+90",
"isUpsService": true,
"tax": {
"type": "string",
"maxValidPrice": 0
},
"flags": {
"w20": "https://cdn.zemlog.com/flags/w20/tr.png",
"w40": "https://cdn.zemlog.com/flags/w40/tr.png"
}
}
],
"meta": {
"page": 1,
"perPage": 50,
"total": 233,
"pageCount": 5
}
}