List Areas

List all available areas with their Truth Scores.

List all available areas with their Truth Scores. Supports pagination and filtering by province.

List Areas

Returns a paginated list of all areas with their current Truth Scores.

GET/v1/areas

Name	Type	Required	Description
`province`	string	optional	Filter by provinceExample: `gauteng`
`limit`	integer	optional	Number of results per page (1-100)Default: `20`
`offset`	integer	optional	Number of results to skipDefault: `0`
`sort`	string	optional	Sort field (name, truth_score, updated_at)Default: `name`
`order`	string	optional	Sort order (asc, desc)Default: `asc`

{

"data": Area[],// Array of area objects

"total": integer,// Total number of areas

"limit": integer,// Results per page

"offset": integer// Current offset

}

Example Request

curl -X GET "https://api.placeiq.co/v1/areas?province=gauteng&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON

{
  "data": [
    {
      "id": "sandton",
      "name": "Sandton",
      "province": "Gauteng",
      "municipality": "City of Johannesburg",
      "truth_score": 8.4,
      "updated_at": "2026-02-22T08:00:00Z"
    },
    {
      "id": "rosebank",
      "name": "Rosebank",
      "province": "Gauteng",
      "municipality": "City of Johannesburg",
      "truth_score": 8.1,
      "updated_at": "2026-02-22T08:00:00Z"
    }
  ],
  "total": 147,
  "limit": 10,
  "offset": 0
}

Filtering by Province

Valid province values:

gauteng - Gauteng
western-cape - Western Cape
kwazulu-natal - KwaZulu-Natal
eastern-cape - Eastern Cape
free-state - Free State
mpumalanga - Mpumalanga
limpopo - Limpopo
north-west - North West
northern-cape - Northern Cape