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
}

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
}