Provinces API

Returns a paginated list of Philippine provinces.

Endpoints

List Provinces

GET /v1/provinces

Returns a list of all provinces in the Philippines.

Query Parameters

Parameter	Type	Required	Description
page	integer	No	Page number (default: 1).
limit	integer	No	Items per page (default: 10, max: 100).

Example Request

curl -H "Authorization: Bearer <token>" \
     "https://api.gis.ph/v1/provinces?limit=5"

Example Response

{
  "data": [
    {
      "id": 1,
      "name": "Abra",
      "code": "140100000",
      "region_id": 140000000
    },
    ...
  ],
  "meta": {
    "total": 82,
    "page": 1,
    "limit": 5,
    "totalPages": 17,
    "links": {
      "self": "...",
      "next": "...",
      "prev": null
    }
  },
  "error": null
}

Search Provinces by PSGC Code

POST /v1/provinces/search

Accepts a list of PSGC province codes and returns matching provinces. Supports both JSON and GeoJSON output formats with optional boundary geometry.

Request Body

Field	Type	Required	Description
codes	string[]	Yes	List of PSGC province codes (1–100 items).
geometry	string	No	Geometry level to include: simple (default), medium, or detailed.
output	string	No	Output format: json (default) or geojson.

Example Request

curl -X POST \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{"codes":["1206500000","0701200000"],"geometry":"simple","output":"geojson"}' \
     "https://api.gis.ph/v1/provinces/search"

Example Response (GeoJSON)

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": { "type": "MultiPolygon", "coordinates": [ ... ] },
      "properties": {
        "id": 135,
        "name": "Bohol",
        "code": "0701200000"
      }
    }
  ]
}

Example Response (JSON)

[
  {
    "id": 135,
    "name": "Bohol",
    "code": "0701200000"
  }
]

Get Single Province

GET /v1/provinces/{id}

Returns detailed information about a single province.

Query Parameters

Parameter	Type	Required	Description
geometry	boolean	No	If true, includes municipality GeoJSON boundaries in the response.

Parameters

• id (path): The unique identifier of the province.

Example Request

curl -H "Authorization: Bearer <token>" \
     "https://api.gis.ph/v1/provinces/94?geometry=true"

Example Response

{
  "data": {
    "id": 94,
    "name": "Kalinga",
    "code": "1403200000",
    "pop": 229570,
    ...
  },
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": { ... },
        "properties": {
          "name": "Tabuk City",
          ...
        }
      }
    ]
  },
  "error": null
}