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

Authorizations

cookieAuthtokenAuth

Query parameters

pageinteger

A page number within the paginated result set.

page_sizeinteger

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

Places that the content API supports.

get

/v3/places/{frbr_uri_code}

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.

List of work expressions for a place.

get

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

Authorizations

cookieAuthtokenAuth

Path parameters

frbr_uri_codestringrequired

Query parameters

created_atstring · date-time

created_at__gtestring · date-time

created_at__ltestring · date-time

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

updated_atstring · date-time

updated_at__gtestring · date-time

updated_at__ltestring · date-time

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": [
    {
      "custom_properties": null,
      "url": "https://example.com",
      "title": "text",
      "created_at": "2025-02-22T06:26:14.514Z",
      "updated_at": "2025-02-22T06:26:14.514Z",
      "country": "text",
      "locality": "text",
      "nature": "text",
      "subtype": "text",
      "actor": "text",
      "year": "text",
      "number": "text",
      "frbr_uri": "text",
      "expression_frbr_uri": "text",
      "publication_date": "2025-02-22",
      "publication_name": "text",
      "publication_number": "text",
      "commenced": true,
      "commenced_in_full": true,
      "commencement_date": "2025-02-22",
      "assent_date": "2025-02-22",
      "expression_date": "2025-02-22",
      "language": "text",
      "stub": true,
      "principal": true,
      "numbered_title": "text",
      "as_at_date": "2025-02-22",
      "type_name": "text",
      "amendments_made": "text",
      "enacted_as": "text",
      "repeals_made": "text",
      "commencements_made": "text",
      "disclaimer": "text",
      "points_in_time": [
        {
          "date": "2025-02-22",
          "expressions": [
            {
              "url": "https://example.com",
              "language": "text",
              "expression_frbr_uri": "text",
              "expression_date": "2025-02-22",
              "title": "text"
            }
          ]
        }
      ],
      "amendments": [
        {
          "date": "2025-02-22",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "work_amendments": [
        {
          "date": "2025-02-22",
          "amending_title": "text",
          "amending_uri": "text"
        }
      ],
      "taxonomy_topics": [
        "text"
      ],
      "links": [
        {
          "rel": "text",
          "title": "text",
          "href": "https://example.com",
          "media_type": "text"
        }
      ],
      "aliases": [
        "text"
      ],
      "publication_document": {
        "url": "https://example.com",
        "filename": "text",
        "mime_type": "text",
        "size": 1
      },
      "commencing_work": {
        "frbr_uri": "text",
        "title": "text"
      },
      "repeal": {
        "date": "2025-02-22",
        "repealing_title": "text",
        "repealing_uri": "text"
      },
      "parent_work": {
        "frbr_uri": "text",
        "title": "text"
      }
    }
  ]
}