DCAT-US 3.0: Dataset Series

Information about a dataset series, including its members, ordering, coverage, and publishing details.

A group of related datasets that are published separately

Type: object
Additional properties: Any type allowed

Example:

{
    "@type": "DatasetSeries",
    "title": "Annual Climate Observations",
    "description": "A series of annual climate observation datasets from monitoring stations.",
    "contactPoint": [
        {
            "fn": "Climate Data Support",
            "hasEmail": "mailto:climate@example.gov"
        }
    ],
    "publisher": {
        "name": "National Climate Data Center"
    },
    "accrualPeriodicity": "annually",
    "issued": "2000-01-15",
    "modified": "2024-12-01",
    "first": {
        "@id": "https://example.gov/datasets/climate-observations-2000",
        "@type": "Dataset",
        "title": "Climate Observations 2000",
        "description": "First year of climate observations.",
        "contactPoint": {
            "fn": "Climate Support",
            "hasEmail": "mailto:climate@example.gov"
        },
        "publisher": {
            "name": "National Climate Data Center"
        },
        "identifier": "https://example.gov/datasets/series-first"
    },
    "last": {
        "@id": "https://example.gov/datasets/climate-observations-2024",
        "@type": "Dataset",
        "title": "Climate Observations 2024",
        "description": "Latest year of climate observations.",
        "contactPoint": {
            "fn": "Climate Support",
            "hasEmail": "mailto:climate@example.gov"
        },
        "publisher": {
            "name": "National Climate Data Center"
        },
        "identifier": "https://example.gov/datasets/series-last"
    },
    "seriesMember": [
        {
            "@id": "https://example.gov/datasets/climate-observations-2022",
            "@type": "Dataset",
            "title": "Climate Observations 2022",
            "description": "Climate observations for 2022.",
            "contactPoint": {
                "fn": "Climate Support",
                "hasEmail": "mailto:climate@example.gov"
            },
            "publisher": {
                "name": "National Climate Data Center"
            },
            "identifier": "https://example.gov/datasets/series-member-001"
        },
        {
            "@id": "https://example.gov/datasets/climate-observations-2023",
            "@type": "Dataset",
            "title": "Climate Observations 2023",
            "description": "Climate observations for 2023.",
            "contactPoint": {
                "fn": "Climate Support",
                "hasEmail": "mailto:climate@example.gov"
            },
            "publisher": {
                "name": "National Climate Data Center"
            },
            "identifier": "https://example.gov/datasets/series-member-002"
        },
        {
            "@id": "https://example.gov/datasets/climate-observations-2024",
            "@type": "Dataset",
            "title": "Climate Observations 2024",
            "description": "Climate observations for 2024.",
            "contactPoint": {
                "fn": "Climate Support",
                "hasEmail": "mailto:climate@example.gov"
            },
            "publisher": {
                "name": "National Climate Data Center"
            },
            "identifier": "https://example.gov/datasets/series-member-003"
        }
    ],
    "spatial": [
        {
            "@type": "Location",
            "bbox": {
                "type": "Polygon",
                "coordinates": [
                    [
                        [
                            -125.0,
                            24.0
                        ],
                        [
                            -66.0,
                            24.0
                        ],
                        [
                            -66.0,
                            50.0
                        ],
                        [
                            -125.0,
                            50.0
                        ],
                        [
                            -125.0,
                            24.0
                        ]
                    ]
                ]
            }
        }
    ],
    "temporal": [
        {
            "@type": "PeriodOfTime",
            "startDate": "2000-01-01",
            "endDate": "2024-12-31"
        }
    ]
}

Property	Type	Requirement Level	Title/Description
description	string	Mandatory	Plain-language summary of the dataset series
title	string	Mandatory	Human-readable title of the dataset series
contactPoint	null or array of Kind classes	Recommended	List of contacts people can use to ask questions or send feedback about the dataset series
first	null or Dataset	Recommended	The first dataset in an ordered dataset series
last	null or Dataset	Recommended	The last dataset in an ordered dataset series
modified	null or object	Recommended	Most recent date when the Dataset Series changed, not the modified date of the newest dataset in the series
publisher	null or Agent	Recommended	Organization responsible for maintaining the Dataset Series as a coherent series; this may differ from publishers of individual datasets
seriesMember	null or array of Dataset classes	Recommended	List of members of the Dataset Series
spatial	null or array of Location classes	Recommended	A geographic region that is covered by the Dataset Series
temporal	null or array of PeriodOfTime classes	Recommended	Time periods covered by the dataset series
@id	string	Optional
@type	string	Optional
accrualPeriodicity	More than one type	Optional	The frequency at which the Dataset Series is updated. This is the series update frequency, not necessarily each dataset’s frequency
issued	null or object	Optional	Date when the Dataset Series was formally established or published, not the release date of the oldest dataset in the series

`DatasetSeries > description` #

Requirement: Mandatory

Plain-language summary of the dataset series

Type: string
Required: Yes

Example:

"An annual series of comprehensive climate observation datasets collected from monitoring stations across the United States. Each dataset in the series covers one calendar year of daily observations."

`DatasetSeries > title` #

Requirement: Mandatory

Human-readable title of the dataset series

Type: string
Required: Yes

Examples:

"Annual Climate Observations"

"Annual National Climate Observations Series"

`DatasetSeries > contactPoint` #

Requirement: Recommended

List of contacts people can use to ask questions or send feedback about the dataset series

Type: null or array of Kind classes

Each item of this array must be:

Kind: Contact information for an individual or entity

`DatasetSeries > first` #

Requirement: Recommended

The first dataset in an ordered dataset series

Type: null or Dataset

`DatasetSeries > last` #

Requirement: Recommended

The last dataset in an ordered dataset series

Type: null or Dataset

`DatasetSeries > modified` #

Title: update/modification date

Requirement: Recommended

Most recent date when the Dataset Series changed, not the modified date of the newest dataset in the series

Type: null or object

Examples:

"2024-12-01"

"2024-06-01"

"2024-01-15T10:30:00Z"

"2024"

"2024-01"

`DatasetSeries > publisher` #

Requirement: Recommended

Organization responsible for maintaining the Dataset Series as a coherent series; this may differ from publishers of individual datasets

Type: null or Agent

`DatasetSeries > seriesMember` #

Requirement: Recommended

List of members of the Dataset Series

Type: null or array of Dataset classes

Each item of this array must be:

Dataset: A collection of data published or curated by one provider

`DatasetSeries > spatial` #

Title: spatial/geographic coverage

Requirement: Recommended

A geographic region that is covered by the Dataset Series

Type: null or array of Location classes

Each item of this array must be:

Location: A named place or geographic area

`DatasetSeries > temporal` #

Title: temporal coverage

Requirement: Recommended

Time periods covered by the dataset series

Type: null or array of PeriodOfTime classes

Each item of this array must be:

PeriodOfTime: Information about a specific time period with a start- and/or end-time

`DatasetSeries > @id` #

Requirement: Optional

Type: string
Format: iri

Example:

"https://example.gov/series/annual-climate-observations"

`DatasetSeries > @type` #

Requirement: Optional

Type: string
Default: "DatasetSeries"

`DatasetSeries > accrualPeriodicity` #

Title: frequency

Requirement: Optional

The frequency at which the Dataset Series is updated. This is the series update frequency, not necessarily each dataset’s frequency

Type: combining
Additional properties: Any type allowed

Example:

"annually"

Any of:

Null allowed when not required
item 1
item 2
item 3

`DatasetSeries > accrualPeriodicity > anyOf > Null allowed when not required` #

Type: null

`DatasetSeries > accrualPeriodicity > anyOf > item 1` #

ISO 19115 Maintenance Frequency code

Type: enum (of string)

Must be one of:

“continual”
“daily”
“weekly”
“fortnightly”
“monthly”
“quarterly”
“biannually”
“annually”
“asNeeded”
“irregular”
“notPlanned”
“unknown”

`DatasetSeries > accrualPeriodicity > anyOf > item 2` #

ISO-8601 Maintenance Frequency code for recurring values, see https://www.iso.org/standard/70907.html

Type: string

Restrictions:

Must match regular expression: ^R/P.+$ Test

`DatasetSeries > accrualPeriodicity > anyOf > item 3` #

Dublin Core Collection Frequency Vocabulary, see https://www.dublincore.org/specifications/dublin-core/collection-description/frequency/#vocabulary-terms

Type: enum (of string)

Must be one of:

“continuous”
“daily”
“weekly”
“biweekly”
“monthly”
“quarterly”
“semiannual”
“annual”
“irregular”
“triennial”
“biennial”
“threeTimesAYear”
“bimonthly”
“semimonthly”
“threeTimesAMonth”
“semiweekly”
“threeTimesAWeek”

`DatasetSeries > issued` #

Title: release date

Requirement: Optional

Date when the Dataset Series was formally established or published, not the release date of the oldest dataset in the series

Type: null or object

Examples:

"2000-01-15"

"2024-01-15T10:30:00Z"

"2024"

"2024-01"

DCAT-US 3.0: Dataset Series

DatasetSeries > description #

DatasetSeries > title #

DatasetSeries > contactPoint #

DatasetSeries > first #

DatasetSeries > last #

DatasetSeries > modified #

DatasetSeries > publisher #

DatasetSeries > seriesMember #

DatasetSeries > spatial #

DatasetSeries > temporal #

DatasetSeries > @id #

DatasetSeries > @type #

DatasetSeries > accrualPeriodicity #

DatasetSeries > accrualPeriodicity > anyOf > Null allowed when not required #

DatasetSeries > accrualPeriodicity > anyOf > item 1 #

DatasetSeries > accrualPeriodicity > anyOf > item 2 #

DatasetSeries > accrualPeriodicity > anyOf > item 3 #

DatasetSeries > issued #

`DatasetSeries > description` #

`DatasetSeries > title` #

`DatasetSeries > contactPoint` #

`DatasetSeries > first` #

`DatasetSeries > last` #

`DatasetSeries > modified` #

`DatasetSeries > publisher` #

`DatasetSeries > seriesMember` #

`DatasetSeries > spatial` #

`DatasetSeries > temporal` #

`DatasetSeries > @id` #

`DatasetSeries > @type` #

`DatasetSeries > accrualPeriodicity` #

`DatasetSeries > accrualPeriodicity > anyOf > Null allowed when not required` #

`DatasetSeries > accrualPeriodicity > anyOf > item 1` #

`DatasetSeries > accrualPeriodicity > anyOf > item 2` #

`DatasetSeries > accrualPeriodicity > anyOf > item 3` #

`DatasetSeries > issued` #