Laws.Africa Developer Guide
  • Laws.Africa Developer Guide
  • Get Started
    • Introduction
    • Quick start
    • Works and expressions
    • Webhooks
    • Changelog
  • Tutorial
    • About the tutorial
    • Module 1: Build a legislation reader
      • Introductory concepts
      • Create a basic Django app
      • Create database models
      • Fetching the data
      • Work listing page
      • Expression detail page
      • Styling with Law Widgets
      • Adding interactivity
      • Staying up to date
    • Module 2: Enrichments and interactivity
      • Basic enrichments
      • Advanced enrichments
      • Advanced interactivity
    • Module 3: Text extraction for search and analysis
      • Why extracting text is important
      • Basics of text extraction
      • Advanced text extraction
      • Extracting text for analysis and machine learning
  • Content API Reference
    • About the Content API
    • Authentication
    • Pagination
    • Places
    • All work expressions
    • Single work expression
      • Commencements
      • Embedded images
      • Publication document
      • Table of Contents
      • Timeline
    • Taxonomy topics
    • Enrichment datasets
  • AI API Reference
    • About the AI API
    • Authentication
    • Knowledge Bases
  • How-to Guides
    • How to use the Table of Contents API
    • How to download images
Powered by GitBook
On this page
  1. Content API Reference

Taxonomy topics

Taxonomies are used to classify works.

PreviousTimelineNextEnrichment datasets

Last updated 1 year ago

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 a taxonomy topic

List work expressions tagged with 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
Query parameters
pageintegerOptional

A page number within the paginated result set.

page_sizeintegerOptional

Number of results to return per page.

Responses
200Success
application/json
get
GET /v3/taxonomy-topics HTTP/1.1
Host: 
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

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

Authorizations
Path parameters
slugstringRequired

Unique short name (code) for the topic.

Responses
200Success
application/json
get
GET /v3/taxonomy-topics/{slug} HTTP/1.1
Host: 
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]"
          ]
        }
      ]
    }
  ]
}
get

List of work expressions for a taxonomy topic.

Authorizations
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
get
GET /v3/taxonomy-topics/{slug}/work-expressions HTTP/1.1
Host: 
Accept: */*
200Success
{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2025-05-15T00:00:48.302Z",
      "updated_at": "2025-05-15T00:00:48.302Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2025-05-15",
      "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-05-15",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2025-05-15",
      "repeal": {
        "date": "2025-05-15",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2025-05-15",
      "language": "text",
      "points_in_time": [
        {
          "date": "2025-05-15",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2025-05-15",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2025-05-15",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2025-05-15",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2025-05-15",
      "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"
      ]
    }
  ]
}
  • List taxonomy topics
  • GET/v3/taxonomy-topics
  • Get a taxonomy topic
  • GET/v3/taxonomy-topics/{slug}
  • List work expressions tagged with a taxonomy topic
  • GET/v3/taxonomy-topics/{slug}/work-expressions