API

Schools and educational institutions

Organization: Kielce City Hall 9 endpoints Technical name: school Version: v1 Managed Public

Schools and educational institutions in Kielce listed in the Register of Schools and Educational Institutions (RSPO). The directory covers public and non-public institutions, including preschools, primary and secondary schools, counselling centres and school complexes. Each entry provides its RSPO identifier, name, type and address, with its location shown on the map.

Tags

  • Education
  • Institutions

Metadata

Organization Kielce City Hall
Data sources Register of Schools and Educational Institutions (RSPO) School and educational institution directory from RSPO.
Imported school statistics Annual student, graduate, grade, birth-year and examination aggregates from configured CSV/XLSX/ODS imports; supplied separately from RSPO directory data. The publisher must document the actual source, reporting date and usage terms for each imported dataset.
API type Managed
Access policy Public
Version v1
License Creative Commons Attribution 4.0 International
Categories Educational institutions
Tags Education, Institutions
Updated at 2 hours ago
Publish from 2026-11-01 00:24

Requests to the whole API service

Loading statistics…

Daily aggregates · UTC

Documentation

The RSPO directory is supplemented by available imported school statistics. Collections are bounded to 100 records and support an exact school-year filter. Statistical collections also support schoolId. Missing rows mean unavailable data, not zero; nullable source values remain null. Grade is a grade level, not a count of classroom sections. Birth-year intervals preserve the source grouping, including an open lower bound. Examination averages are decimal strings. Institution tax identifiers, contact details and individual records are excluded.

API endpoints

OpenAPI JSON OpenAPI YAML 9 endpoints
GET /schools Schools json

List synchronized schools, optionally restricted to an exact discovered institutionTypeId.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/schools?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
institutionTypeId query integer optional Exact institution type identifier discovered through /school-types; select preschool or point types from the persisted dictionary. 1
Request 
GET /api/public/school/schools?limit=25&offset=0
Response 
[
  {
    "uri": "https://data.example.test/api/public/school/schools/12345",
    "id": 12345,
    "name": "Public Primary School",
    "type": "Primary school",
    "addressStreet": "Krakowska",
    "addressNumber": "10",
    "location": {"lat": 50.8501, "lon": 20.6154}
  }
]
GET /schools/{schoolId} School json

Return one school by its stable RSPO identifier.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/schools/{schoolId}?version=v1

Parameters

Name Location Type Required Description example
schoolId path integer required Stable RSPO school identifier. 12345
Request 
GET /api/public/school/schools/12345
Response 
{
  "uri": "https://data.example.test/api/public/school/schools/12345",
  "id": 12345,
  "name": "Public Primary School",
  "type": "Primary school",
  "addressStreet": "Krakowska",
  "addressNumber": "10",
  "location": {"lat": 50.8501, "lon": 20.6154}
}
GET /school-years School years json

List configured school years and their calendar date boundaries, newest first.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/school-years?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
Request 
GET /api/public/school/school-years?year=2024%2F2025&limit=25&offset=0
Response 
[{"id":"2024/2025","fromDate":"2024-09-01","toDate":"2025-08-31"}]
GET /students Annual student totals json

List available student and graduate totals per school and year.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/students?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
schoolId query integer optional Stable RSPO school identifier. 12345
Request 
GET /api/public/school/students?year=2024%2F2025&limit=25&offset=0
Response 
[{"schoolId":12345,"year":"2024/2025","studentsQuantity":120,"graduatesQuantity":18}]
GET /students/grades Students by grade and gender json

List student counts by grade level and gender; these are not classroom section counts.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/students/grades?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
schoolId query integer optional Stable RSPO school identifier. 12345
Request 
GET /api/public/school/students/grades?year=2024%2F2025&limit=25&offset=0
Response 
[{"schoolId":12345,"year":"2024/2025","grade":4,"quantityFemales":10,"quantityMales":12}]
GET /students/ages Students by birth year json

List student counts by inclusive birth-year interval; a null lower bound is open.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/students/ages?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
schoolId query integer optional Stable RSPO school identifier. 12345
Request 
GET /api/public/school/students/ages?year=2024%2F2025&limit=25&offset=0
Response 
[{"schoolId":12345,"year":"2024/2025","birthYearFrom":null,"birthYearTo":2015,"quantity":22}]
GET /exams/summaries Examination summaries json

List examination type, participant and certificate counts per school and year; unavailable counts remain null.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/exams/summaries?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
schoolId query integer optional Stable RSPO school identifier. 12345
Request 
GET /api/public/school/exams/summaries?year=2024%2F2025&limit=25&offset=0
Response 
[{"schoolId":12345,"year":"2024/2025","examType":"e8","participantsTotal":18,"certificatesTotal":null}]
GET /exams/results Examination subject results json

List examination results with subject identifier and name, level and optional scope; unavailable participants and decimal average remain null.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/exams/results?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
year query string optional Exact school-year identifier with consecutive years, for example 2024/2025. 2024/2025
schoolId query integer optional Stable RSPO school identifier. 12345
Request 
GET /api/public/school/exams/results?year=2024%2F2025&limit=25&offset=0
Response 
[{"schoolId":12345,"year":"2024/2025","examType":"e8","subjectId":"00000000-0000-4000-8000-000000000001","subjectName":"Mathematics","level":"basic","scope":null,"participants":18,"average":"71.25"}]
GET /school-types School institution types json

List synchronized institution type identifiers and names to select directory subsets, including preschools and preschool points.

Data publication metadata
License Creative Commons Attribution 4.0 International
Organization Kielce City Hall
Openness level
Categories Educational institutions
Tags Education, Institutions
Data sources Register of Schools and Educational Institutions (RSPO) , Imported school statistics
Contact smartcity@kielce.eu
Try endpoint

Response schemas

Check the documented response schemas in the OpenAPI document.

Open the OpenAPI document

Endpoint

/api/public/school/school-types?version=v1

Parameters

Name Location Type Required Description example
limit query integer optional Maximum number of records to return (at most 100). 25
offset query integer optional Number of records to skip. -
Request 
GET /api/public/school/school-types?limit=25&offset=0
Response 
[{"id":1,"name":"Example institution type"}]