API

Spatial planning acts

Organization: Kielce City Hall 6 endpoints Technical name: planning-act Version: v1 Managed Public

Planning acts and their published versions, formal documents and spatial features. The API includes only versions delivered through available public dataset GML files.

Tags

  • MPZP
  • Spatial planning

Metadata

Organization Kielce City Hall
Data sources ISDP Source system for spatial and register data.
API type Managed
Access policy Public
Version v1
License Creative Commons Attribution 4.0 International
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Updated at 4 hours ago
Publish from 2026-11-01 01:39

Requests to the whole API service

Loading statistics…

Daily aggregates · UTC

Documentation

Versions delivered through available public dataset GML distributions. Lists use limit (1–100, default 25) and offset (default 0), with stable ordering. Acts select the latest published version before filtering its lifecycle. Private datasets and withdrawn distributions are excluded. Features use EPSG:4326; missing values remain null. Invalid filters return 400; unavailable details return 404.

API endpoints

OpenAPI JSON OpenAPI YAML 6 endpoints
GET /acts Planning acts json

Latest published version per act, ordered by act UUID.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/acts?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum records: 1–100, default 25. -
offset query integer optional Records to skip, default 0. -
actType query string optional Act type: general_plan, local_spatial_plan or landscape_resolution. -
lifecycleState query string optional Lifecycle: effective, in_progress or obsolete; for acts filters the latest published version. -
actId query string optional Planning-act UUID. -
Request 
GET /api/public/planning-act/acts?limit=25&offset=0
Response 
[
    {
        "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
        "id": "01900000-0000-7000-8000-000000000001",
        "namespace": "PL.EXAMPLE",
        "localId": "PLAN_1",
        "actType": "local_spatial_plan",
        "title": "Example planning act",
        "lifecycleState": "effective",
        "latestPublishedVersionId": "01900000-0000-7000-8000-000000000002",
        "latestPublishedVersionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002"
    }
]
GET /acts/{actId} Planning act json

Act metadata and latest published version.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/acts/{actId}?version=v1

Parameters

Name Location Type Required Description example
actId path string required Planning-act UUID. -
Request 
GET /api/public/planning-act/acts/01900000-0000-7000-8000-000000000001
Response 
{
    "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
    "id": "01900000-0000-7000-8000-000000000001",
    "namespace": "PL.EXAMPLE",
    "localId": "PLAN_1",
    "actType": "local_spatial_plan",
    "title": "Example planning act",
    "lifecycleState": "effective",
    "latestPublishedVersionId": "01900000-0000-7000-8000-000000000002",
    "latestPublishedVersionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002"
}
GET /versions Published versions json

Public versions ordered by act UUID and version UUID.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/versions?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum records: 1–100, default 25. -
offset query integer optional Records to skip, default 0. -
actType query string optional Act type: general_plan, local_spatial_plan or landscape_resolution. -
lifecycleState query string optional Lifecycle: effective, in_progress or obsolete; for acts filters the latest published version. -
actId query string optional Planning-act UUID. -
Request 
GET /api/public/planning-act/versions?limit=25&offset=0
Response 
[
    {
        "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "id": "01900000-0000-7000-8000-000000000002",
        "actId": "01900000-0000-7000-8000-000000000001",
        "actUri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
        "namespace": "PL.EXAMPLE",
        "localId": "PLAN_1",
        "actType": "local_spatial_plan",
        "actIdentifier": "PLAN_1",
        "title": "Example planning act",
        "lifecycleState": "effective",
        "sourceVersion": "2026-01-01",
        "versionStartedAt": "2026-01-01T00:00:00Z",
        "versionEndedAt": null,
        "effectiveFrom": null,
        "effectiveTo": null,
        "changeNumber": null,
        "modification": null
    }
]
GET /versions/{versionId} Published version json

Version metadata and legal validity dates.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/versions/{versionId}?version=v1

Parameters

Name Location Type Required Description example
versionId path string required Published version UUID. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002
Response 
{
    "uri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
    "id": "01900000-0000-7000-8000-000000000002",
    "actId": "01900000-0000-7000-8000-000000000001",
    "actUri": "https:\/\/data.example.test\/api\/public\/planning-act\/acts\/01900000-0000-7000-8000-000000000001",
    "namespace": "PL.EXAMPLE",
    "localId": "PLAN_1",
    "actType": "local_spatial_plan",
    "actIdentifier": "PLAN_1",
    "title": "Example planning act",
    "lifecycleState": "effective",
    "sourceVersion": "2026-01-01",
    "versionStartedAt": "2026-01-01T00:00:00Z",
    "versionEndedAt": null,
    "effectiveFrom": null,
    "effectiveTo": null,
    "changeNumber": null,
    "modification": null
}
GET /versions/{versionId}/documents Formal documents json

Paginated metadata of current formal documents for a published version.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/versions/{versionId}/documents?version=v1

Parameters

Name Location Type Required Description example
versionId path string required Published version UUID. -
limit query integer optional Maximum records: 1–100, default 25. -
offset query integer optional Records to skip, default 0. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002/documents?limit=25&offset=0
Response 
[
    {
        "versionId": "01900000-0000-7000-8000-000000000002",
        "versionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "gmlId": "DOC_1",
        "externalIdentifier": "PL.EXAMPLE.DOC_1",
        "title": "Example resolution",
        "documentDate": null,
        "documentDateType": null,
        "identificationNumber": null,
        "establishingAuthority": null,
        "role": null
    }
]
GET /versions/{versionId}/features Spatial features json

Paginated current boundaries and zones, with geometry in EPSG:4326.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Economy, Housing, Spatial data and geography
Tags MPZP, Spatial planning
Data sources ISDP
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/planning-act/versions/{versionId}/features?version=v1

Parameters

Name Location Type Required Description example
versionId path string required Published version UUID. -
limit query integer optional Maximum records: 1–100, default 25. -
offset query integer optional Records to skip, default 0. -
Request 
GET /api/public/planning-act/versions/01900000-0000-7000-8000-000000000002/features?limit=25&offset=0
Response 
[
    {
        "versionId": "01900000-0000-7000-8000-000000000002",
        "versionUri": "https:\/\/data.example.test\/api\/public\/planning-act\/versions\/01900000-0000-7000-8000-000000000002",
        "objectType": "act_boundary",
        "gmlId": "BOUNDARY_1",
        "externalIdentifier": "PL.EXAMPLE.BOUNDARY_1",
        "label": null,
        "designation": null,
        "symbol": null,
        "geometry": null
    }
]