Reference

Get a country

get/countries/{code}

Request

  • Base URL
    https://gorest.co.in/public/v3
  • URL
    https://gorest.co.in/public/v3/countries/{code}
  • Auth
    none required

Query parameters

countriesstring

fields[countries]=name,currency_code returns only those fields; code is always there.

include'currency'

currency adds the currency of each item.

Headers

If-None-Matchstring

An ETag from an earlier answer; an unchanged item answers 304 with no body.

Response

The item.

alpha3string
calling_codestring nullable

The E.164 country calling code; null where there is none.

codestring required

ISO 3166-1 alpha-2.

currency_codestring nullable

The currency in use; null where there is none.

namestring
numeric_codestring
region'Africa' | 'Americas' | 'Asia' | 'Europe' | 'Oceania' | 'null' nullable

The UN M49 continent; null for Antarctica.

Example response

{
  "alpha3": "IND",
  "calling_code": "+91",
  "code": "IN",
  "currency": {
    "code": "INR",
    "minor_unit": 2,
    "name": "Indian Rupee",
    "symbol": "₹"
  },
  "currency_code": "INR",
  "name": "India",
  "numeric_code": "356"
}

Changes

No recorded changes to this operation across all 1 revision of this API.