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.

Example: https://microservices.schoolwijzer.ivs.amsterdam/voorrangsscholen/api/v1/voorrangsscholen?page[number]=1&filter[jaargang]=2021-2022&filter[postcode]=1094HE&filter[huisnummer]=131&filter[huisletter]=&filter[huisnummertoevoeging]=

GEOJSON

Locations and childcare can also be viewed in GeoJSON format.

Root URLs:

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: