GET
/countriesDictionariesCountry dictionary and search
Country dictionary with localized names and ISO codes.
- Page with
after_id: passmeta.next_after_iduntilmeta.has_moreis false. - Results are ordered by ID, not by match quality. Sort by name in your UI.
- Batch lookup with
ids[]=208&ids[]=1, up to 100 IDs.
Query parameters
5querystring≤ 200 charsOptional literal name-prefix search. Countries also search native names, ISO codes and stored translations. Blank text disables this filter.
ids[]integer[]≥ 1 · ≤ 100 itemsBatch lookup. Repeat ids[]=2001&ids[]=3001; not a comma-separated string. Unknown IDs are omitted. Intersects other filters.
per_pageinteger1–1,000 · default 100Maximum returned records. Empty, noninteger or out-of-range values return 422.
after_idinteger≥ 1Exclusive ID cursor. Omit initially; then use meta.next_after_id with unchanged filters. Not a page number. Empty or nonpositive values return 422.
langstringResponse locale. Option translations are also limited by the account languages. The page selects its current language automatically.
GET
/countriescurl -g "https://api.lotarius.com/countries?api_key=$CARS_API_KEY" \
-H "Accept: application/json"ExamplesRecorded
{2 keys
"data": [3 items
0: {6 keys
"id": 1
"name": "Afghanistan"
"original_name": "Afghanistan"
"native": "افغانستان"
"iso": "AF"
"iso3": "AFG"
1: {6 keys
"id": 2
"name": "Aland Islands"
"original_name": "Aland Islands"
"native": "Åland"
"iso": "AX"
"iso3": "ALA"
2: {6 keys
"id": 3
"name": "Albania"
"original_name": "Albania"
"native": "Shqipëria"
"iso": "AL"
"iso3": "ALB"
