Skip to main content
Version: 1.0

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"
}
}