GET /v1/names/countries

Countries the Person and Name fields support.

Request

No body, no query parameters.

curl https://api.alchemy.example/v1/names/countries \
  -H "X-Api-Key: YOUR_API_KEY"

Response

An array of { code, name }, alphabetical by name. code is the value countries[].country accepts on a Person or Name field, in upper or lower case:

[
  { "code": "ar", "name": "Argentina" },
  { "code": "au", "name": "Australia" },
  { "code": "us", "name": "United States" }
]

The entries above are an example. Call the endpoint for the current list.

{ "type": "Person", "countries": [{ "country": "us" }] }

Not every country supports the same options. For example, race and Hispanic origin are only available for us. See Name for the options each country supports.

Requires an API key (see Authentication) but is not billed.