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

get

Places that the content API supports.

Authorizations

cookieAuthtokenAuth

Query parameters

pageintegeroptional

A page number within the paginated result set.

page_sizeintegeroptional

Number of results to return per page.

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/places'

200

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

get

Places that the content API supports.

Authorizations

cookieAuthtokenAuth

Path parameters

frbr_uri_codestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/places/{frbr_uri_code}'

200

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.

get

List of work expressions for a place.

Authorizations

cookieAuthtokenAuth

Path parameters

frbr_uri_codestringrequired

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

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v3/places/{frbr_uri_code}/work-expressions'

200

200

{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2025-03-31T03:31:54.201Z",
      "updated_at": "2025-03-31T03:31:54.201Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2025-03-31",
      "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-03-31",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2025-03-31",
      "repeal": {
        "date": "2025-03-31",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2025-03-31",
      "language": "text",
      "points_in_time": [
        {
          "date": "2025-03-31",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2025-03-31",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2025-03-31",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2025-03-31",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2025-03-31",
      "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"
      ]
    }
  ]
}