Open Data Services Codelist Schema

A schema for documenting codelists in CSV format.

This page presents the schema as a table. You can also download it as JSON Schema.

Tip

To reference the codelist schema, use its canonical URI:

https://codelist-schema.readthedocs.io/1__0__0/codelist-schema.json

Title

Description

Type

Format

Required

Code

string

Required

Code

The value to use in data. Codes should match the letter case of external codes (e.g. ISO 4217, JSON Schema, GeoJSON, IANA Media Types) and should be camel case, otherwise.

Title

string

Required

Title

A short title for the code.

Description

string

Required

Description

A longer description of the code.

Deprecated

[string, null]

Deprecated

The minor version (or patch version under 0.x) in which the code was deprecated.

Deprecation note

[string, null]

Deprecation note

The reason for the deprecation, and any guidance.

Business Logic

[string, null]

Business Logic

A description of how this field’s value relates to the values of other fields.

Category

[string, null]

Category

A single category by which to filter codes. The standard’s documentation should explain the categorization system.

Notes

string

Notes

Notes on the application of the code.

Source

object

Source

The third-party source for the code.

Valid Until

[string, null]

Valid Until

The date past which the code is no longer valid for use.

Appreciation

The codelist schema is based on the codelist schema developed by the Open Contracting Partnership for the Open Contracting Data Standard.