Skip to main content

​
Input Flexibility

When sending country data to our API, you can use any of these formats:

Alpha-3

Three-letter codes (e.g., ‘AUS’)

Alpha-2

Two-letter codes (e.g., ‘AU’)

Full Names

Complete country names (e.g., ‘Australia’)

​
How It Works

1

Input Processing

The service accepts your country input in any ISO-3166 compliant format
2

Normalization

Automatically converts the input to ISO-3166-alpha3 format
3

Validation

Verifies the converted code against ISO standards
If the service can’t convert your country input to a valid ISO-3166-alpha3 code, the request will be rejected with an error response.

​
Example Usage

{
  "country": "Australia",  // Will be converted to "AUS"
  "nationality": "AU",     // Will be converted to "AUS"
  "residency": "AUS"      // Already in correct format
}

​
ISO-3166 Country Codes Reference

For a complete list of valid country codes and their formats, refer to the ISO-3166 Country Codes Wikipedia page . Common examples:
  • 🇦🇺 Australia: AUS (AU)
  • 🇬🇧 United Kingdom: GBR (GB)
  • 🇺🇸 United States: USA (US)
  • 🇨🇦 Canada: CAN (CA)