Location Data — List Countries

Returns the complete list of countries with basic metadata (ISO code, phone code, capital, currency, symbol, region, coordinates, and nationality).

Limitations: This endpoint is read-only and returns all countries; no filters or pagination are supported.

GET{gateway}/us/api/v1/countries

Payload

This endpoint does not accept a request body or query params. Send an empty payload.

Response

Attribute	Type	Description
data	Array<Object>	List of country objects.
data[].id	Integer	Country ID.
data[].name	String	Country name.
data[].iso2	String	ISO 3166-1 alpha-2 code.
data[].phoneCode	String	Country calling code.
data[].capital	String	Capital city.
data[].currency	String	Currency code (e.g., EUR).
data[].curencySymbol	String	Currency symbol.
data[].region	String	Geographic region.
data[].latitude	String	Latitude.
data[].longitude	String	Longitude.
data[].nationality	String	Demonym/nationality.

200 — SUCCESS

{
  "data": [
    {
      "id": 6,
      "name": "Andorra",
      "iso2": "AD",
      "phoneCode": "376",
      "capital": "Andorra la Vella",
      "currency": "EUR",
      "curencySymbol": "€",
      "region": "Europe",
      "latitude": "1.50000000",
      "longitude": "42.50000000",
      "nationality": "Andorran"
    },
    {
      "id": 7,
      "name": "Angola",
      "iso2": "AO",
      "phoneCode": "244",
      "capital": "Luanda",
      "currency": "AOA",
      "curencySymbol": "Kz",
      "region": "Africa",
      "latitude": "18.50000000",
      "longitude": "-12.50000000",
      "nationality": "Angolan"
    }
  ]
}

422 — FAILED

{
  "code": 1000,
  "message": "Invalid payload. Please check your request.",
  "type": "INVALID_PAYLOAD",
  "errors": [
    {
      "key": "countryId",
      "reason": "Invalid value provided."
    }
  ]
}

Create User Location Data — List States by Country