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
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/places HTTP/1.1
Host: 
Accept: */*
200Success
{
  "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
Path parameters
frbr_uri_codestringRequired
Responses
200Success
application/json
get
GET /v3/places/{frbr_uri_code} HTTP/1.1
Host: 
Accept: */*
200Success
{
  "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
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
200Success
application/json
get
GET /v3/places/{frbr_uri_code}/work-expressions HTTP/1.1
Host: 
Accept: */*
200Success
{
  "count": 123,
  "next": "text",
  "previous": "text",
  "results": [
    {
      "url": "https://example.com",
      "title": "text",
      "created_at": "2025-06-27T09:42:07.576Z",
      "updated_at": "2025-06-27T09:42:07.576Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2025-06-27",
      "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-06-27",
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "assent_date": "2025-06-27",
      "repeal": {
        "date": "2025-06-27",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "expression_date": "2025-06-27",
      "language": "text",
      "points_in_time": [
        {
          "date": "2025-06-27",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2025-06-27",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2025-06-27",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2025-06-27",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "taxonomy_topics": [
        "text"
      ],
      "as_at_date": "2025-06-27",
      "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"
      ]
    }
  ]
}

Last updated