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
@id string Optional  
@type string Optional  
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 More than one type Recommended The first dataset in an ordered dataset series
last More than one type Recommended The last dataset in an ordered dataset series
seriesMember null or array of Dataset classes Recommended List of members of the Dataset Series
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
description string Mandatory Plain-language summary of the dataset series
issued More than one type Optional Date when the Dataset Series was formally established or published, not the release date of the oldest dataset in the series
modified More than one type Recommended Most recent date when the Dataset Series changed, not the modified date of the newest dataset in the series
publisher More than one type Recommended Organization responsible for maintaining the Dataset Series as a coherent series; this may differ from publishers of individual datasets
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
title string Mandatory Human-readable title of the dataset series

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 > 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 Description
Kind Contact information for an individual or entity

DatasetSeries > first #

Requirement: Recommended

The first dataset in an ordered dataset series

Type combining
Additional properties Any type allowed
Any of
Null allowed when not required
Dataset

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

| Type | null | | ——– | —— |

DatasetSeries > first > anyOf > Dataset #

inline description of the first dataset

Type object
Additional properties Any type allowed
Defined in Dataset

See Also: (related supporting classes)

DatasetSeries > last #

Requirement: Recommended

The last dataset in an ordered dataset series

Type combining
Additional properties Any type allowed
Any of
Null allowed when not required
Dataset

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

| Type | null | | ——– | —— |

DatasetSeries > last > anyOf > Dataset #

inline description of the last dataset

Type object
Additional properties Any type allowed
Same definition as Dataset

See Also: (related supporting classes)

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 Description
Dataset A collection of data published or curated by one provider

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 > 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 > 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 combining
Additional properties Any type allowed

Examples:

"2000-01-15"

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

"2024"

"2024-01"
Any of
Null allowed when not required
Date string

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

| Type | null | | ——– | —— |

DatasetSeries > issued > anyOf > Date string #

Type combining
Additional properties Any type allowed
Any of
item 0
item 1
item 2
item 3

DatasetSeries > issued > anyOf > Date string > anyOf > item 0 #

Type string
Format date-time

DatasetSeries > issued > anyOf > Date string > anyOf > item 1 #

Type string
Format date

DatasetSeries > issued > anyOf > Date string > anyOf > item 2 #

A year in YYYY format

| Type | string | | ——– | ——– |

Restrictions  
Must match regular expression ^[0-9]{4}$ Test

DatasetSeries > issued > anyOf > Date string > anyOf > item 3 #

A year and month in YYYY-MM format

| Type | string | | ——– | ——– |

Restrictions  
Must match regular expression ^[0-9]{4}-[0-9]{2}$ Test

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 combining
Additional properties Any type allowed

Examples:

"2024-12-01"

"2024-06-01"

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

"2024"

"2024-01"
Any of
Null allowed when not required
Date string

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

| Type | null | | ——– | —— |

DatasetSeries > modified > anyOf > Date string #

Type combining
Additional properties Any type allowed
Any of
item 0
item 1
item 2
item 3

DatasetSeries > modified > anyOf > Date string > anyOf > item 0 #

Type string
Format date-time

DatasetSeries > modified > anyOf > Date string > anyOf > item 1 #

Type string
Format date

DatasetSeries > modified > anyOf > Date string > anyOf > item 2 #

A year in YYYY format

| Type | string | | ——– | ——– |

Restrictions  
Must match regular expression ^[0-9]{4}$ Test

DatasetSeries > modified > anyOf > Date string > anyOf > item 3 #

A year and month in YYYY-MM format

| Type | string | | ——– | ——– |

Restrictions  
Must match regular expression ^[0-9]{4}-[0-9]{2}$ Test

DatasetSeries > publisher #

Requirement: Recommended

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

Type combining
Additional properties Any type allowed
Any of
Null allowed when not required
Agent

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

| Type | null | | ——– | —— |

DatasetSeries > publisher > anyOf > Agent #

inline description of publisher

Type object
Additional properties Any type allowed
Same definition as Agent

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 Description
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 Description
PeriodOfTime Information about a specific time period with a start- and/or end-time

DatasetSeries > title #

Requirement: Mandatory

Human-readable title of the dataset series

Type string
Required Yes

Examples:

"Annual Climate Observations"

"Annual National Climate Observations Series"