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

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

get

/v3/taxonomy-topics

Authorizations

cookieAuthtokenAuth

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/taxonomy-topics'

200

200

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

Get a taxonomy topic

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

get

/v3/taxonomy-topics/{slug}

Authorizations

cookieAuthtokenAuth

Path parameters

slugstringrequired

Unique short name (code) for the topic.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/taxonomy-topics/{slug}'

200

200

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

List work expressions tagged with a taxonomy topic

List of work expressions for a taxonomy topic.

get

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

Authorizations

cookieAuthtokenAuth

Path parameters

slugstringrequired

Query parameters

created_atstring · date-time

created_at__gtestring · date-time

created_at__ltestring · date-time

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

updated_atstring · date-time

updated_at__gtestring · date-time

updated_at__ltestring · date-time

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/taxonomy-topics/{slug}/work-expressions'

200

200

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2025-03-12T03:53:31.901Z",
      "updated_at": "2025-03-12T03:53:31.901Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2025-03-12",
      "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": "2025-03-12",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2025-03-12",
      "repeal": {
        "date": "2025-03-12",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2025-03-12",
      "language": "text",
      "points_in_time": [
        {
          "date": "2025-03-12",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2025-03-12",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2025-03-12",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2025-03-12",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2025-03-12",
      "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"
      ]
    }
  ]
}