Overview

Transform your international applications with comprehensive country intelligence featuring complete ISO 3166-1 compliance, fuzzy text matching, and extensive country metadata. This service provides authoritative country information essential for applications requiring accurate geographic, political, and international data about all world countries and territories.

Perfect for e-commerce platforms requiring country validation, international shipping applications managing global destinations, and government systems implementing geographic compliance. The service supports multiple lookup methods including country names, ISO2/ISO3 codes, and numeric identifiers, with advanced fuzzy matching for user-friendly search experiences.

Designed for developers building international applications without the complexity of maintaining country datasets or handling regional variations. Whether you're building address validation systems, international commerce platforms, or global data visualization applications, this service provides the authoritative country data foundation needed for professional applications serving worldwide audiences.

API URL

GET /countries, GET /countries/:code, GET /countries/search, GET /countries/match, GET /export

Headers

Code

Content-Type: application/json

Query Parameters

Param

Type

Description

code

required

string

ISO2, ISO3, or numeric country code (for /countries/:code endpoint)

Example GET Request

Code

GET /countries/search?q=united

Successful Response

Status

HTML

200 OK

Body

Code

[
  {
    "countryName": "United States",
    "iso2": "US",
    "iso3": "USA",
    "numericCode": "840"
  }
]

Field

Type

success

boolean

data

object

data.countryName

string

data.iso2

string

data.iso3

string

data.numericCode

integer

Error Response

Example

Code

404 NOT_FOUND â€“ Country not found by provided identifier
400 BAD_REQUEST â€“ Invalid search query or code format
500 INTERNAL_ERROR â€“ Database connection or query error

Last Updated: May 4, 2026

DP.

API Documentation

API URL

GET /countries, GET /countries/:code, GET /countries/search, GET /countries/match, GET /export

Example GET Request

Successful Response

Error Response

API URL

GET /countries, GET /countries/:code, GET /countries/search, GET /countries/match, GET /export

coderequiredstring

Example GET Request

Successful Response

successboolean

dataobject

data.countryNamestring

data.iso2string

data.iso3string

data.numericCodeinteger

metaobject

meta.countinteger

meta.querystring

meta.matchTypestring

meta.similaritynumber

meta.timestampstring

meta.correlationIdstring

Error Response