DoAThing

Look up a country's codes

ISO codes, currency, dialling code and region, from a name or a code.

A country name or an ISO code.

1 credit

Needs Query.

What it does

Also called: look up a country code · find the iso code for a country · what currency does a country use.

Use it from your own code

The same endpoint this page calls — no daily cap, 1 credit a call either way.

POST /v1/core/country-lookup

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.

NameInTypeDefaultNotes
query *bodystring—A country name or an ISO code.