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://fdc3.finos.org/schemas/next/context/country.schema.json (github)

Type

fdc3.country

Properties

id (required)

type: object

Subproperties:

COUNTRY_ISOALPHA2

type: string

Two-letter ISO country code

COUNTRY_ISOALPHA3

type: string

Three-letter ISO country code

ISOALPHA2

type: string

Two-letter ISO country code. Deprecated in FDC3 2.0 in favour of the version prefixed with COUNTRY_.

ISOALPHA3

type: string

Three-letter ISO country code. Deprecated in FDC3 2.0 in favour of the version prefixed with COUNTRY_.

name

type: string

An optional human-readable name for the country

Example

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