Cities & Municipalities

Returns a paginated list of Philippine cities and municipalities.

Endpoints

List Cities and Municipalities

GET /v1/municities

Returns a list of cities and municipalities. Filtering by province is required.

Query Parameters

Parameter	Type	Required	Description
province	string	Yes	Exact (case-insensitive) name of the province.
name	string	No	Starts-with search for the city or municipality name.
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/municities?province=Bohol&name=Al&limit=2"

Example Response

{
  "data": [
    {
      "id": 1595,
      "name": "Alburquerque",
      "type": "Municipal",
      "province": {
        "id": 135,
        "code": "0701200000",
        "name": "Bohol"
      }
    },
    {
      "id": 1596,
      "name": "Alicia",
      "type": "Municipal",
      "province": {
        "id": 135,
        "code": "0701200000",
        "name": "Bohol"
      }
    }
  ],
  "meta": {
    "total": 2,
    "page": 1,
    "limit": 2,
    "totalPages": 1,
    "links": {
      "self": "...",
      "next": "...",
      "prev": null
    }
  },
  "error": null
}

Get Single Municipality

GET /v1/municities/{id}

Returns detailed information about a single city or municipality.

Query Parameters

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

Parameters

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

Example Request

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

Example Response

{
  "data": {
    "id": 1595,
    "name": "City of Isabela",
    "code": "1001301000",
    ...
  },
  "geojson": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": { ... },
        "properties": {
          "name": "Poblacion",
          ...
        }
      }
    ]
  },
  "error": null
}

Errors

Status Code	Description
400	Bad Request - Missing required province parameter.
401	Unauthorized - Invalid or missing API key.
404	Not Found - Municipality ID does not exist.