Connect key
GET/countriesDictionaries

Country dictionary and search

Country dictionary with localized names and ISO codes.

  • Page with after_id: pass meta.next_after_id until meta.has_more is 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

5
querystring≤ 200 chars

Optional literal name-prefix search. Countries also search native names, ISO codes and stored translations. Blank text disables this filter.

ids[]integer[]≥ 1 · ≤ 100 items

Batch lookup. Repeat ids[]=2001&ids[]=3001; not a comma-separated string. Unknown IDs are omitted. Intersects other filters.

per_pageinteger1–1,000 · default 100

Maximum returned records. Empty, noninteger or out-of-range values return 422.

after_idinteger≥ 1

Exclusive ID cursor. Omit initially; then use meta.next_after_id with unchanged filters. Not a page number. Empty or nonpositive values return 422.

langstring

Response locale. Option translations are also limited by the account languages. The page selects its current language automatically.

Returns · Country objects in data, with meta.has_more and meta.next_after_id.
GET/countries
curl -g "https://api.auctionsapi.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"
}
]
"meta": {3 keys}
}

Get API access

Connect your key to run every request on these pages against your own data. No key yet? Ask us for a demo key: the same JSON as the paid plans.

I have a key