Laws.Africa Developer Guide
Search…
Quick start
A quick introduction to using the Laws.Africa Content API.
This quick start guide will get you started with fetching legislation from the Laws.Africa Content API. It includes:
- 1.Signing up for a Laws.Africa account
- 2.Listing available legislation
- 3.Fetching the HTML for a piece of legislation
- 4.Displaying the HTML
This guide uses the Cape Town by-laws as example content, which is free and doesn't require an API subscription. Other content such as national laws require a subscription.
Create an account
To get started, you'll need a free Laws.Africa account and API token.
- 1.
- 2.
In the examples below, replace
<YOUR_AUTH_TOKEN> with your personal API token.Once you're signed into your account, you can also visit the API URLs in your browser.
Get a list of by-laws
Fetch a list of the by-laws (municipal legislation) for the City of Cape Town.
1
$ curl -H "Authorization: Token <YOUR_AUTH_TOKEN>" \
2
https://api.laws.africa/v2/akn/za-cpt/.json
Copied!
The
za-cpt part of the URL identifies the City of Cape Town in South Africa.Fetch the Animal by-law
Let's fetch the details of Cape Town's Animal by-law, in JSON format. This includes the title, publication details and a list of other API calls you can make for additional details.
1
$ curl -H "Authorization: Token <YOUR_AUTH_TOKEN>" \
2
https://api.laws.africa/v2/akn/za-cpt/act/by-law/2011/animal.json
Copied!
Laws.Africa can provide us with a Table of Contents for the by-law, also in JSON format. Let's fetch that:
1
$ curl -H "Authorization: Token <YOUR_AUTH_TOKEN>" \
2
https://api.laws.africa/v2/akn/za-cpt/act/by-law/2011/animal/toc.json
Copied!
Now let's get the HTML content of Section 3 of the by-law, regarding dog registration and licensing:
1
$ curl -H "Authorization: Token <YOUR_AUTH_TOKEN>" \
2
https://api.laws.africa/v2/akn/za-cpt/act/by-law/2011/animal/eng/main/section/3.html
Copied!
Display the by-law
Finally, let's put that HTML into a webpage and include some stylesheets to make it look good:
1
<link rel="stylesheet" type="text/css"
2
href="https://cdn.jsdelivr.net/gh/laws-africa/indigo-web/css/akoma-ntoso.min.css">
3
​
4
<div class="akoma-ntoso">
5
<section class="akn-section" id="section-3" data-id="section-3">
6
<h3>3. Dog registration and licensing</h3>
7
<section class="akn-subsection" id="section-3.1" data-id="section-3.1">
8
<span class="akn-num">(1)</span>
9
<span class="akn-content"><span class="akn-p">The <span class="akn-term" data-refersTo="#term-owner" id="trm78" data-id="trm78">owner</span> of a property where one or more dogs are kept must register the <span class="akn-term" data-refersTo="#term-dog" id="trm79" data-id="trm79">dog</span> or dogs with the <span class="akn-term" data-refersTo="#term-Council" id="trm80" data-id="trm80">Council</span>.</span></span>
10
</section>
11
<section class="akn-subsection" id="section-3.2" data-id="section-3.2">
12
<span class="akn-num">(2)</span>
13
<span class="akn-content"><span class="akn-p">Dog registration must take place within four months of the <span class="akn-term" data-refersTo="#term-dog" id="trm81" data-id="trm81">dog</span>’s birth or within 30 days of acquiring a <span class="akn-term" data-refersTo="#term-dog" id="trm82" data-id="trm82">dog</span> on property within <span class="akn-term" data-refersTo="#term-Council" id="trm83" data-id="trm83">Council</span>’s jurisdictional boundaries.</span></span>
14
</section>
15
<section class="akn-subsection" id="section-3.3" data-id="section-3.3">
16
<span class="akn-num">(3)</span>
17
<span class="akn-content"><span class="akn-p">The <span class="akn-term" data-refersTo="#term-Council" id="trm84" data-id="trm84">Council</span> may levy a <span class="akn-term" data-refersTo="#term-dog" id="trm85" data-id="trm85">dog</span> license fee in respect of a property where one or more dogs are kept.</span></span>
18
</section>
19
<section class="akn-subsection" id="section-3.4" data-id="section-3.4">
20
<span class="akn-num">(4)</span>
21
<span class="akn-content"><span class="akn-p">The amount of the <span class="akn-term" data-refersTo="#term-dog" id="trm86" data-id="trm86">dog</span> license fee may be determined in terms of a resolution of <span class="akn-term" data-refersTo="#term-Council" id="trm87" data-id="trm87">Council</span>. A reduced <span class="akn-term" data-refersTo="#term-dog" id="trm88" data-id="trm88">dog</span> license fee may apply for sterilized dogs.</span></span>
22
</section>
23
</section>
24
</div>
Copied!
Next steps
Last modified 3mo ago