Retrieves a code list by ID for a specific country
Access control: this endpoint is available to users with the
everyonerole.
A Code List is a controlled set of predefined, standardized values used to populate specific fields in electronic documents (such as e-invoices). Each code has a stable, machine-readable identifier and a human-readable description. Code Lists are typically based on global standards (e.g., UN/CEFACT, ISO, EN16931) and may include jurisdiction-specific extensions or restrictions.
Code Lists are versioned, and each version may have defined effective and sunset dates to ensure that the correct set of allowable values is applied according to regulatory or jurisdictional requirements.
By default, the API returns only non-expired code list versions (versions where the sunset date has not passed). To retrieve expired versions or filter by specific date ranges, use the effectiveDate and sunsetDate query parameters.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
System-generated unique identifier of the code list definition. Typically a UUID used to reference this code list internally or via APIs.
Headers
Header that specifies the API version to use (for example “1.6”).
Optional header for a client identifier string used for diagnostics (for example “Fingerprint”).
Query parameters
Two-letter ISO 3166-1 alpha-2 country code indicating the jurisdiction this code list applies to.
Filter code list versions by effective date. Returns versions that are effective on or before this date. Format: YYYY-MM-DD (ISO 8601). If not specified, defaults to the current date. sunsetDate is required when effectiveDate is provided.
Filter code list versions by sunset date. Returns versions that have not yet sunset on or before this date. Format: YYYY-MM-DD (ISO 8601). If not specified, only non-expired versions are returned.
Response
Two-letter ISO 3166-1 alpha-2 country code indicating the jurisdiction this code list applies to.
System-generated unique identifier of the code list definition. Typically a UUID used to reference this code list internally or via APIs.
Human-readable name of the code list, usually describing what the codes represent (for example, document types, tax categories, currencies).
Textual description of the code list, including what it is used for and whether it represents a global standard (e.g., UN/CEFACT, ISO, EN16931) or a jurisdiction-specific/local extension of that standard.
Identifier of the underlying standard or authoritative source for this code list. This may be a formal code list name (e.g., UNCL1001), a standard reference (e.g., EN16931), or an internal standard identifier.
Array of versioned definitions of this code list for the given jurisdiction. Each entry represents a version that is valid for a specific effective/sunset date range, optionally per locale.