School Finder OpenData API
School Finder offers its data in the form of an OpenData API.
The data thus becomes accessible to developers who can write their own applications on it.
Structure of the API
The API follows the JSON:API standard. All information on this can be found at https://jsonapi.org/. The full spec is supported by this API.
All API requests can be made to https://schoolwijzer.amsterdam.nl/api/v2/{datatype}. See below for a list of
available data types.
Use sparse fieldsets to make the dataset you retrieve as small as possible. This makes requests faster and saves bandwidth: https://jsonapi.org/format/#fetching-sparse-fieldsets
👉 Note: all API responses are limited to 75 results. See the JSON:API documentation on pagination to find out more about how to read the full dataset.
Datatypes
Locations
Root URL: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen.
Content: a complete overview of all locations in Amsterdam.
Available filters
soort_onderwijs
Multiple options possible. Choose from:
- basisonderwijs
- speciaal-basisonderwijs
- speciaal-onderwijs
- voortgezet-en-speciaal-basisonderwijs
- voortgezet-speciaal-onderwijs
- voortgezet-onderwijs
- middelbaar-beroepsonderwijs
Example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[soort_onderwijs]=basisonderwijs
Note, provide this filter value as an array. See example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[soort_onderwijs][]=basisonderwijs
brin6
Use this filter to search for a single location by its unique brin6 code.
Example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[brin6]=04IU00
stadsdeel
Choose from:
- Centrum
- Noord
- Oost
- Zuidoost
- Zuid
- West
- Nieuw-west
- Westpoort
- Weesp
- Buiten Amsterdam
Example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[stadsdeel]=Noord
grondslag (foundation)
Filter locations by denomination (grondslag). Choose from:
- algemeen-bijzonder
- antroposofisch
- evangelisch
- evangelische-broedergemeenschap
- gereformeerd
- gereformeerd-vrijgemaakt
- hindoeistisch
- humanistisch
- interconfessioneel
- islamitisch
- joods
- levensbeschouwelijk
- oecumenisch
- openbaar
- protestants-christelijk
- katholiek
- rooms-katholiek
- samenwerking-pc-rk
Example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[grondslag]=openbaar
onderconcept
Filter locations by educational concept. Choose from:
- dalton
- jenaplan
- ontwikkelingsgericht
- vrije-school
- montessori
- natuurlijk-leren
Example: https://schoolwijzer.amsterdam.nl/api/v2/vestigingen?filter[onderwijsconcept]=dalton
Childcare
Root URL: https://schoolwijzer.amsterdam.nl/api/v2/kinderopvang.
Content: a complete overview of all childcare locations in Amsterdam.
Available filters
lrkp_id
Use this filter to look up a single location by its unique lrkp_id.
Example: https://schoolwijzer.amsterdam.nl/api/v2/kinderopvang?filter[lrkp_id]=101160434
is_vroegschool
Use this filter to retrieve only locations that are early childhood schools. Accepted values are 1 or 0, yes or no.
Example: https://schoolwijzer.amsterdam.nl/api/v2/kinderopvang?filter[is_vroegschool]=1
Preschools by primary school
All preschools can thus be retrieved by requesting the Childcare locations with the above-mentioned early childhood school.
To retrieve preschools by primary school location, it is best to use the include query parameter, a standard from the JSON:API standard.
The following URL gives all preschools in Amsterdam, with their locations: https://schoolwijzer.amsterdam.nl/api/v2/kinderopvang?filter[is_vroegschool]=1&include=vestigingen. This makes it possible to relate early childhood schools to primary schools.
Priority schools
👉 Note that priority schools can be retrieved on a dedicated endpoint. So this differs from the other API endpoints!
Root URL: https://microservices.schoolwijzer.ivs.amsterdam/voorrangsscholen/api/v1/voorrangsscholen
Content: the list of priority schools for a given address. Note: it is mandatory to provide an address in this API, as priority schools are always linked to a specific home address.
Required filters:
- page[number] Required parameter. Value is 1.
- filter[jaargang] A textual representation of the school year in which the priority schools are valid. For example: "2021-2022".
- filter[postcode] Postal code of the address for which priority schools are requested.
- filter[huisnummer] The house number without addition or house letter.
- filter[huisletter] Any corresponding house letter.
- filter[huisnummertoevoeging] Any corresponding house number addition.
Note: all filters are required. If a value is empty, it can be specified in the URL as &huisletter=, with no value. See also below the sample URL.
GEOJSON
Locations and childcare can also be viewed in GeoJSON format.
Root URLs:
- https://schoolwijzer.amsterdam.nl/api/v2/geojson/vestigingen
- https://schoolwijzer.amsterdam.nl/api/v2/geojson/kinderopvang
These APIs can be used to plot locations on a map.
Individual locations can be found in the API by pasting their ID after the root URL: