Places

List the places - countries and localities (sub-country regions) - that are available from the Content API.

All Laws.Africa content belongs to a country or a locality within a country. A locality is a jurisdiction within a country, such as a province or municipality. Together, they form a two-level hierarchy.

Place codes

Countries are identified using two-letter ISO 3166-1 alpha-2 country codes, such as na or za.

Localities are identified using a combination of the country code and a locality code specific to the country, such as za-cpt.

Locality codes are not well standardised and may vary between different countries. In South Africa, for example, municipalities are identified by the codes determined by the South African Municipal Demarcation Board.

Get places

Places that the content API supports.

GET/v3/places

Authorization

cookieAuthtokenAuth

Query parameters

Response

200

Body

application/json

countinteger

Example: 123

nextnullable string

previousnullable string

resultsarray of Place (object)

Request

JavaScriptCurlPython

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

Response

200

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "code": "text",
      "name": "text",
      "frbr_uri_code": "text",
      "localities": [
        {
          "code": "text",
          "name": "text",
          "frbr_uri_code": "text",
          "links": [
            {
              "rel": "text",
              "title": "text",
              "href": "https://example.com",
              "media_type": "text"
            }
          ]
        }
      ],
      "links": [
        {
          "rel": "text",
          "title": "text",
          "href": "https://example.com",
          "media_type": "text"
        }
      ]
    }
  ]
}

Get a place

Places that the content API supports.

GET/v3/places/{frbr_uri_code}

Authorization

cookieAuthtokenAuth

Path parameters

frbr_uri_code*string

Response

200

Body

application/json

code*string

ISO 3166-1 alpha-2 country code.

name*string

Name of the country in English.

frbr_uri_code*string

FRBR URI code for this place.

localitiesarray of Locality (object)

Localities within this place.

links*array of Link (object)

A list of alternate links for this place.

Request

JavaScriptCurlPython

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

Response

200

{
  "code": "text",
  "name": "text",
  "frbr_uri_code": "text",
  "localities": [
    {
      "code": "text",
      "name": "text",
      "frbr_uri_code": "text",
      "links": [
        {
          "rel": "text",
          "title": "text",
          "href": "https://example.com",
          "media_type": "text"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "text",
      "title": "text",
      "href": "https://example.com",
      "media_type": "text"
    }
  ]
}

Get work expressions for a place

Use the frbr_uri_code for the place to fetch work expressions in that place.

List of work expressions for a place.

GET/v3/places/{frbr_uri_code}/work-expressions

Authorization

cookieAuthtokenAuth

Path parameters

frbr_uri_code*string

Query parameters

Response

200

Body

application/json

countinteger

Example: 123

nextnullable string

previousnullable string

resultsarray of WorkExpression (object)

Request

JavaScriptCurlPython

const response = await fetch('/v3/places/{frbr_uri_code}/work-expressions', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2024-12-21T13:14:00.808Z",
      "updated_at": "2024-12-21T13:14:00.808Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2024-12-21",
      "publication_name": "text",
      "publication_number": "text",
      "publication_document": {
        "url": "https://example.com",
        "filename": "text",
        "mime_type": "text",
        "size": 0
      },
      "commenced": false,
      "commenced_in_full": false,
      "commencement_date": "2024-12-21",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2024-12-21",
      "repeal": {
        "date": "2024-12-21",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2024-12-21",
      "language": "text",
      "points_in_time": [
        {
          "date": "2024-12-21",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2024-12-21",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2024-12-21",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2024-12-21",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": false,
      "principal": false,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2024-12-21",
      "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"
      ]
    }
  ]
}