comecerodocs

Get a country

GET
/countries/{code}

Gets one country by its two-letter code, in any case. This needs no token.

Path Parameters

code*string

The ISO 3166-1 alpha-2 country code, such as US or de.

Response Body

The country.

application/json
  1. response

A country, with what an address form for it needs.

name?string

The country's name in English.

code?string

The ISO 3166-1 alpha-2 code.

currency_code?|

The ISO 4217 code of the country's currency.

currency_code_alternate?|

A second currency in common use there, if any.

default_locale?|

The usual locale, such as en-US.

is_eu?boolean

True for a country Comecero treats as in the EU for VAT.

has_postal_code?boolean

True when addresses there use a postal code.

requires_state_prov?boolean

True when an address there needs a state or province.

state_taxes?boolean

True when sales tax depends on the state or province.

states?array<>

The states or provinces, for the countries that list them.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/countries/CA'
Example Response
{  "name": "Canada",  "code": "CA",  "currency_code": "CAD",  "currency_code_alternate": null,  "default_locale": "en-CA",  "is_eu": false,  "has_postal_code": true,  "requires_state_prov": true,  "state_taxes": true,  "states": [    {      "name": "Alberta",      "code": "AB"    },    {      "name": "British Columbia",      "code": "BC"    }  ]}