Documentation

Reference / v1

Countries

Lists recognised ISO 3166-1 alpha-2 country and territory codes, with English display names resolved by the runtime.

Live
GET/api/v1/countries
Live requestRuns from your browser

Parameters

This endpoint has no request parameters.

Example request

curl 'https://informantion.com/api/v1/countries/ZA'

Example response

{
  "success": true,
  "data": {
    "name": "South Africa",
    "iso2": "ZA"
  }
}

Response schema

namestring
English display name.
iso2string
ISO 3166-1 alpha-2 code.

Possible errors

404 · COUNTRY_NOT_FOUNDThe alpha-2 code is not recognised.
429 · RATE_LIMITEDThe current fair-use window is exhausted.

Rate limit

60 requests per minute under the current anonymous fair-use policy. Check the response headers for the active window.