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.
A page number within the paginated result set.
Number of results to return per page.
GET /v3/taxonomy-topics HTTP/1.1
Host:
Accept: */*
{
"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
API endpoint for listing taxonomy topics. Taxonomy topics are a tree structure of topics that are applied to documents to categorise them.
Unique short name (code) for the topic.
GET /v3/taxonomy-topics/{slug} HTTP/1.1
Host:
Accept: */*
{
"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
List of work expressions for a taxonomy topic.
A page number within the paginated result set.
Number of results to return per page.
GET /v3/taxonomy-topics/{slug}/work-expressions HTTP/1.1
Host:
Accept: */*
{
"count": 123,
"next": "text",
"previous": "text",
"results": [
{
"url": "https://example.com",
"title": "text",
"created_at": "2025-06-27T09:39:18.354Z",
"updated_at": "2025-06-27T09:39:18.354Z",
"country": "text",
"locality": "text",
"nature": "text",
"subtype": "text",
"actor": "text",
"year": "text",
"number": "text",
"frbr_uri": "text",
"expression_frbr_uri": "text",
"publication_date": "2025-06-27",
"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-06-27",
"commencing_work": {
"frbr_uri": "text",
"title": "text"
},
"assent_date": "2025-06-27",
"repeal": {
"date": "2025-06-27",
"repealing_title": "text",
"repealing_uri": "text"
},
"parent_work": {
"frbr_uri": "text",
"title": "text"
},
"expression_date": "2025-06-27",
"language": "text",
"points_in_time": [
{
"date": "2025-06-27",
"expressions": [
{
"url": "https://example.com",
"language": "text",
"expression_frbr_uri": "text",
"expression_date": "2025-06-27",
"title": "text"
}
]
}
],
"amendments": [
{
"date": "2025-06-27",
"amending_title": "text",
"amending_uri": "text"
}
],
"work_amendments": [
{
"date": "2025-06-27",
"amending_title": "text",
"amending_uri": "text"
}
],
"stub": true,
"principal": true,
"numbered_title": "text",
"taxonomy_topics": [
"text"
],
"as_at_date": "2025-06-27",
"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"
]
}
]
}
Last updated