Provinces

Provinces

GET /v1/provinces

List provinces (optionally filter by region):

curl -H "Authorization: Bearer $GISPH_API_KEY" "https://api.gis.ph/v1/provinces?region_id=reg_001&limit=50"

Response (200):

{
  "data": [
    { "id": "prov_001", "name": "Cebu", "region_id": "reg_002", "code": "CEB" },
    { "id": "prov_002", "name": "Bohol", "region_id": "reg_002", "code": "BOH" }
  ]
}

GET /v1/provinces/{province_id}

Retrieve a province by ID.

curl -H "Authorization: Bearer $GISPH_API_KEY" "https://api.gis.ph/v1/provinces/prov_001"

Response (200):

{ "id": "prov_001", "name": "Cebu", "region_id": "reg_002", "code": "CEB" }

POST /v1/provinces

Create a province.

Request payload:

{
  "name": "Nueva Vizcaya",
  "region_id": "reg_001",
  "code": "NVZ"
}

Example (curl):

curl -X POST -H "Authorization: Bearer $GISPH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Nueva Vizcaya","region_id":"reg_001","code":"NVZ"}' \
  "https://api.gis.ph/v1/provinces"

Response (201):

{ "id": "prov_123", "name": "Nueva Vizcaya", "region_id": "reg_001", "code": "NVZ" }