Enrichment datasets

Enrichment datasets add additional detail to provisions of a work.

The provisions (chapters, sections, paragraphs, etc.) of a work can be enriched with additional information. This information is stored separately to the content of the provision.

Explore the tutorial for working with enrichment datasets.

Module 2: Enrichments and interactivity

These enrichments are grouped into enrichment datasets. An enrichment dataset contains multiple enrichments for multiple works.

An enrichment dataset has a root taxonomy topic. This is the root of the taxonomy tree that the enrichment dataset uses. Provisions enriched by the dataset can be tagged with a taxonomy topic that is part of the enrichment dataset's taxonomy tree.

An enrichment is made up of:

  • the work being enriched

  • the eId of the provision being enriched

  • the enrichment data:

    • a topic in the taxonomy topic tree associated with the enrichment dataset

An enrichment applies to a provision across all expressions of a work.

List enrichment datasets

get

API for fetching details of enrichment datasets that contain provision-level enrichments for works.

Authorizations
Query parameters
pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

updated_at__gtestring · date-timeOptional
updated_at__ltestring · date-timeOptional
Responses
200Success
application/json
get
GET /v3/enrichment-datasets HTTP/1.1
Host: 
Accept: */*
200Success
{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "id": 1,
      "name": "text",
      "description": "text",
      "url": "https://example.com",
      "created_at": "2025-06-27T10:15:31.824Z",
      "updated_at": "2025-06-27T10:15:31.824Z"
    }
  ]
}

Get details of an enrichment dataset

get

API for fetching details of enrichment datasets that contain provision-level enrichments for works.

Authorizations
Path parameters
idintegerRequired

A unique integer value identifying this enrichment dataset.

Responses
200Success
application/json
get
GET /v3/enrichment-datasets/{id} HTTP/1.1
Host: 
Accept: */*
200Success
{
  "id": 1,
  "name": "text",
  "description": "text",
  "url": "https://example.com",
  "created_at": "2025-06-27T10:15:31.824Z",
  "updated_at": "2025-06-27T10:15:31.824Z",
  "enrichments": [
    {
      "id": 1,
      "provision_id": "text",
      "taxonomy_topic": "text",
      "work": "text"
    }
  ],
  "taxonomy": {
    "name": "text",
    "slug": "text",
    "id": 1,
    "children": [
      {
        "name": "text",
        "slug": "text",
        "id": 1,
        "children": [
          "[Circular Reference]"
        ]
      }
    ]
  }
}

Last updated