Early Childhood Services Directory – API
The Ministry currently has two ECE Directory Application Programming Interfaces (APIs):
- (New) Early Childhood Services Directory
- (Deprecated) Early Childhood Services Directory
We recommend using the (New) Early Childhood Services Directory API. The (Deprecated) Early Childhood Services Directory API will be removed by 1 July 2024.
The ECE Directory Builder uses the (New) Early Childhood Services Directory API.
(New) Early Childhood Services Directory
Click here to go to the data.govt.nz Data Explorer for the (New) Early Childhood Services Directory API.
Details are included on the data.govt.nz site regarding downloading this dataset, as well as further information related to using APIs to facilitate more in-depth querying capabilities.
These files can also be accessed via the data.govt.nz Application Programming Interfaces (APIs). Among other things the APIs can assist you to:
- combine the data with other datasets
- make real-time calls to the datasets to make sure you’ve got the most recent data
- provide a link from your application to a dataset on Data.govt.nz
The APIs offers a series of actions, such as
- resource metadata show - Gets the metadata of a specific data resource. The data resource download link, last updated date, etc. can be retrieved here.
- Datastore search sql - Execute SQL queries on the DataStore to search data in a resource or connect multiple resources with join expressions.
The data.govt.nz DataStore API allows you to access and query the rows and columns of raw data listed by agencies in machine readable format via a JSON API endpoint. For SQL queries this endpoint is https://catalogue.data.govt.nz/api/action/datastore_search_sql and the data sources for the ?sql= parameter are identified by Resource ID, shown in the table below:
| Resource | ID |
|---|---|
| (New) Early Childhood Services Directory | a9d65b07-8483-4b05-bdfd-d2abe4f38827 |
So for instance, a request to: https://catalogue.data.govt.nz/api/3/action/datastore_search_sql?sql=SELECT * FROM"a9d65b07-8483-4b05-bdfd-d2abe4f38827" will return all rows and columns from the (New) Early Childhood Services Directory dataset.
NB: The data in Ministry datasets contain macrons, so the query needs macrons as well. That is, specifying the column “Māori” as “Maori” will fail with a complaint that no such column exists.
Further technical documentation is available at https://docs.ckan.org/en/2.7/maintaining/datastore.html#the-datastore-api.
(Deprecated) Early Childhood Services Directory
The (Deprecated) Early Childhood Services Directory API will be removed by 1 July 2024
Click here to go to the data.govt.nz Data Explorer for the (Deprecated) Early Childhood Education Directory API.
The data.govt.nz DataStore API allows you to access and query the rows and columns of raw data listed by agencies in machine readable format via a JSON API endpoint. For SQL queries this endpoint is https://catalogue.data.govt.nz/api/action/datastore_search_sql and the data sources for the ?sql= parameter are identified by Resource ID, shown in the table below:
| Resource | ID |
|---|---|
| (Deprecated) Early Childhood Services Directory | f65dfeb4-94be-4879-957c-e081d9570216 |
NB: The data in Ministry datasets contain macrons, so the query needs macrons as well. That is, specifying the column “Māori” as “Maori” will fail with a complaint that no such column exists.
Further technical documentation is available at https://docs.ckan.org/en/2.7/maintaining/datastore.html#the-datastore-api.
Technical Notes
Email Addresses
Only early childhood services that agreed to the public release of their email address have those addresses listed here. Persons or organisations wishing to send email material to individuals or organisations whose email addresses appear in this directory must comply with the requirements of the Unsolicited Electronic Messages Act 2007. Publication of email addresses on this site should not be taken as deemed consent to receiving unsolicited email.
Ethnic Classification
The term "ethnicity" refers to the ethnic group or groups to which an individual belongs. The concept of ethnicity adopted by the Ministry of Education is a social construct of group affiliation and identity. The Ministry of Education uses the definition of ethnicity used by Statistics New Zealand, namely:
A social group whose members have one or more of the following characteristics:
- they share a sense of common origins,
- they claim a common and distinctive history and destiny,
- they possess one or more dimensions of collective cultural individuality,
- they feel a sense of unique collective solidarity.
Where possible, ethnicity data is presented as a multiple response. Multiple response works by considering each ethnicity a person affiliates with as one data entry. For example, the data relating to an individual who affiliates as both Māori and Pacific will be included in both categories. They are, however, included only once in the total. This approach is easily undertaken when data is collected in a disaggregate fashion. The rolls in the (New) Early Childhood Services Directory are multiple response.
The early childhood service rolls in the (Deprecated) Early Childhood Services Directory are prioritised. Prioritisation of ethnicity is when people are allocated to one of the ethnicities they have recorded that they affiliate with. This allocation is performed using a predetermined order of ethnic groups. In the early childhood API where ethnicity is prioritised it is in the order of Māori, Pacific, Asian, other groups except European/Pākehā, and European/Pākehā.
European/Pākehā (labelled as European in both APIs) refers to people who affiliate as New Zealand European, Other European or European (not further defined). For example, this includes, but is not limited to, people who consider themselves as Australian (not including Australian Aborigines), British and Irish, American, Spanish, and Ukrainian.