Taxonomy topics

Taxonomies are used to classify works.

Taxonomies are used to categorise and group works. Taxonomies are made up of topics that form a tree structure. Each topic has a unique slug which identifies the topic.

A work may be associated with zero, one or many taxonomy topics.

List taxonomy topics

get

API endpoint for listing taxonomy topics. Taxonomy topics are a tree structure of topics that are applied to documents to categorise them.

Authorizations

cookieAuthtokenAuth

sessionidstringRequired

Query parameters

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Responses

200Success

application/json

countintegerOptionalExample: 123

nextstring · nullableOptional

previousstring · nullableOptional

get/v3/taxonomy-topics

HTTPcURLJavaScriptPython

GET /v3/taxonomy-topics HTTP/1.1
Accept: */*

200Success

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "name": "text",
      "slug": "text",
      "id": 1,
      "children": [
        {
          "name": "text",
          "slug": "text",
          "id": 1,
          "children": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

Get a taxonomy topic

get

API endpoint for listing taxonomy topics. Taxonomy topics are a tree structure of topics that are applied to documents to categorise them.

Authorizations

cookieAuthtokenAuth

sessionidstringRequired

Path parameters

slugstringRequired

Unique short name (code) for the topic.

Responses

200Success

application/json

Details of an entry in the taxonomy topic tree.

namestring · max: 512Required

Name of the taxonomy topic

slugstring · max: 4096Required

Unique short name (code) for the topic.

Pattern: ^[-a-zA-Z0-9_]+$

idintegerRead-onlyRequired

get/v3/taxonomy-topics/{slug}

HTTPcURLJavaScriptPython

GET /v3/taxonomy-topics/{slug} HTTP/1.1
Accept: */*

200Success

{
  "name": "text",
  "slug": "text",
  "id": 1,
  "children": [
    {
      "name": "text",
      "slug": "text",
      "id": 1,
      "children": [
        {
          "name": "text",
          "slug": "text",
          "id": 1,
          "children": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

List work expressions tagged with a taxonomy topic

get

List of work expressions for a taxonomy topic.

Authorizations

cookieAuthtokenAuth

sessionidstringRequired

Path parameters

slugstringRequired

Query parameters

created_atstring · date-timeOptional

created_at__gtestring · date-timeOptional

created_at__ltestring · date-timeOptional

pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

updated_atstring · date-timeOptional

updated_at__gtestring · date-timeOptional

updated_at__ltestring · date-timeOptional

Responses

200Success

application/json

countintegerOptionalExample: 123

nextstring · nullableOptional

previousstring · nullableOptional

get/v3/taxonomy-topics/{slug}/work-expressions

HTTPcURLJavaScriptPython

GET /v3/taxonomy-topics/{slug}/work-expressions HTTP/1.1
Accept: */*

200Success

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2026-07-21T10:17:41.677Z",
      "updated_at": "2026-07-21T10:17:41.677Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2026-07-21",
      "publication_name": "text",
      "publication_number": "text",
      "publication_document": {
        "url": "https://example.com",
        "filename": "text",
        "mime_type": "text",
        "size": 1
      },
      "commenced": true,
      "commenced_in_full": true,
      "commencement_date": "2026-07-21",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2026-07-21",
      "repeal": {
        "date": "2026-07-21",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2026-07-21",
      "language": "text",
      "points_in_time": [
        {
          "date": "2026-07-21",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2026-07-21",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2026-07-21",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2026-07-21",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2026-07-21",
      "custom_properties": null,
      "type_name": "text",
      "amendments_made": "text",
      "enacted_as": "text",
      "repeals_made": "text",
      "commencements_made": "text",
      "links": [
        {
          "rel": "text",
          "title": "text",
          "href": "https://example.com",
          "media_type": "text"
        }
      ],
      "disclaimer": "text",
      "aliases": [
        "text"
      ]
    }
  ]
}