Skip to main content
Version: 2.1

Country

A country entity.

Notes:

  • It is valid to include extra properties and metadata as part of the country payload, but the minimum requirement is for at least one standardized identifier to be provided

    • COUNTRY_ISOALPHA2 SHOULD be preferred.

  • Try to only use country identifiers as intended and specified in the ISO standard. E.g. the COUNTRY_ISOALPHA2 property must be a recognized value and not a proprietary two-letter code. If the identifier you want to share is not a standardized and recognized one, rather define a property that makes it clear what value it is. This makes it easier for target applications.

Schema​

https://github.com/finos/FDC3/tree/main/schemas/context/country.schema.json

Type​

fdc3.country

Properties​

id​

Type: object

Subproperties​

COUNTRY_ISOALPHA2​
  • Type: string
  • Description: Two-letter ISO country code
COUNTRY_ISOALPHA3​
  • Type: string
  • Description: Three-letter ISO country code
ISOALPHA2​
  • Type: string
  • Description: Two-letter ISO country code. Deprecated in FDC3 2.0 in favour of the version prefixed with COUNTRY_.
ISOALPHA3​
  • Type: string
  • Description: Three-letter ISO country code. Deprecated in FDC3 2.0 in favour of the version prefixed with COUNTRY_.

Example Value: 

{
  "COUNTRY_ISOALPHA2": "SE"
}

Example​

{
  "type": "fdc3.country",
  "name": "Sweden",
  "id": {
    "COUNTRY_ISOALPHA2": "SE"
  }
}