Table of Contents

Fetching the Table of Contents for an expression.

You can get a description of the table of contents (TOC) of a work. This includes the chapters, parts, sections and schedules that make up the legislation.

How to use the Table of Contents API

Get the Table of Contents for an expression

Get a Table of Contents (TOC)

API that returns a description of the table of contents (TOC) for a work.

GET/v3/{frbr_uri}/toc

Authorization

cookieAuthtokenAuth

Path parameters

frbr_uri*string

The FRBR URI of the work or work expression, without the first slash, such as akn/za/act/1994/2/

Response

200

Body

application/json

toc*array of TOCEntry (object)

Request

JavaScriptCurlPython

const response = await fetch('/v3/{frbr_uri}/toc', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "toc": [
    {
      "type": "text",
      "component": "text",
      "title": "text",
      "basic_unit": false,
      "num": "text",
      "id": "text",
      "heading": "text",
      "children": [],
      "url": "https://example.com"
    }
  ]
}

Individual parts, chapters and sections

You can use the url field from an item in the Table of Contents to fetch the details of just that item in XML or HTML.

Content for a single part, chapter or section

GET https://api.laws.africa/v3/:frbr-uri/:toc-item.:format

Get the content of a particular Table of Contents item.

Path Parameters

Name	Type	Description
frbr-uri	string	The full FRBR URI for the expression.
toc-item	string	The Table of Contents item to fetch.
format	string	Response format: XML or HTML.

200 The HTML or XML of the requested item.

<section class="akn-section" id="section-9" data-id="section-9"><h3>9. The rescue of stray dogs</h3>
<section class="akn-paragraph akn--no-indent" id="section-9.paragraph-0" data-id="section-9.paragraph-0">
<span class="akn-content"><span class="akn-p">A <span class="akn-term" data-refersTo="#term-person" id="trm257" data-id="trm257">person</span> who rescues a stray <span class="akn-term" data-refersTo="#term-dog" id="trm258" data-id="trm258">dog</span> shall report the date and time of the rescue and a description of the <span class="akn-term" data-refersTo="#term-dog" id="trm259" data-id="trm259">dog</span> to the <span class="akn-term" data-refersTo="#term-Council" id="trm260" data-id="trm260">Council</span> within twenty four hours.</span></span></section></section>