List Countries

The country codes accepted in a relation’s address.country_code.

The row set is the list the API actually validates against (the Peppol code list, see app/countries.py), not the translation table: a list that offered a code the API refuses — or hid one it accepts — would be worse than useless. The two differ by a handful of codes, whose label is therefore null until Fidly has a translation for them.

GET /countries

List Countries

cURL

curl --request GET \
  --url https://api.fidly.be/countries \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "code": "<string>",
    "label": "<string>"
  }
]

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

language · string · required

Language the labels are returned in, one of ['fr', 'en', 'nl', 'de']. Required: a list of codes with no wording to display them is of no use, and there is no sensible language to pick on the caller's behalf.

Response

200

application/json

Successful Response

code · string · required

ISO 3166-1 alpha-2 code (e.g. BE).

label · string | null · required

Name of the country, in the requested language. null for the handful of codes the API accepts but for which Fidly has no translation yet.