POST /v1/core/country-lookup
Country lookup
ISO codes, currency, dialling code and region, from a name or a code.
Look up a country's codes now No key, no code — 1 credit either way.
curl -X POST "$DOATHING_API/v1/core/country-lookup" \
-H "x-api-key: $DOATHING_KEY" \
-H "content-type: application/json" \
-d '{"query": "Japan"}'
ISO codes, currency, dialling code and region, from a name or a code.
Resolve a country from a name or code to ISO alpha-2, alpha-3, numeric, currency and calling code.
Response
The result carries your remaining balance alongside it, so you can track spend without a second call.
{
"name": "Japan",
"alpha_2": "JP",
"alpha_3": "JPN",
"currency": "JPY",
"calling_code": "+81",
"request_id": "37f01edb-0163-42a1-ac51-0acaef979800",
"credits_remaining": 96
}
Cost
1 credit per call, whether it is run from the site or from the API — the credential differs, the price does not. A new account starts with 20 credits.
A rejected request still costs a credit: the authorizer decrements before the tool validates. A call rejected for a missing or invalid key is free.
Parameters
Generated from the endpoint’s own validation, so this is exactly what it accepts. A body field goes at the top level; an option goes inside options.
| Name | In | Type | Default | Notes |
|---|---|---|---|---|
| query * | body | string | — | A country name or an ISO code. |