For the complete documentation index, see llms.txt. This page is also available as Markdown.

Country List

Endpoint

GET/v2/geo/country/get

Link

Retrieves a comprehensive list of countries with their ISO codes and full names. Useful for dropdown menus and country selection in forms.


Request

Headers

Key
Value
Required

Authorization

Bearer <JWT>

Yes

Accept

application/json

Yes


Response (200 OK)

Returns an array of country objects with ISO codes and names.

Response Fields

Country Object

Field
Type
Description
Example

iso

string

ISO 3166-1 alpha-2 country code (2 letters).

"US"

name

string

Full country name.

"United States"

Example Response:

json


Examples

Request

bash

Full Response Example

json


Error Responses

  1. Unauthorized:

    json


Notes

  • ISO Standard: Uses ISO 3166-1 alpha-2 codes (2-letter codes).

  • Sorting: Countries are typically sorted alphabetically by name.

  • Localization: Country names are returned in English by default.

  • Completeness: Includes all internationally recognized countries.

Common Use Cases:

  • User registration forms

  • Address information

  • Compliance and regulatory requirements

  • Geographic filtering

Real request Example

Real response example

200 OK

Last updated