Careers New Zealand jobs and industries API overview

Find out how to access job and industry information through the Careers New Zealand API (application program interface).

The Careers New Zealand jobs and industries application programming interface (API) lets you access information about more than 400 types of jobs in New Zealand. Careers New Zealand job information covers:

  • jobs by industry

  • what a job involves

  • how to enter the job

  • opportunities associated with the job.

The API makes available two sections of this information:

  • Jobs.

  • Industries.

Getting started

The jobs and industries API is designed to be easy to use. There are, however, a few things you need to know before you start using it.

Access and authentication

Access to the Careers New Zealand API will be granted on receipt of a signed memorandum of understanding.

You will also need to request an access password by emailing api@careers.govt.nz, or calling 0800 222 733.

The API has basic authentication via HTTPS.

Formats supported

The Careers New Zealand API only supports JavaScript Object Notation (JSON) response format.

Creating an API request

To make an API request, you’ll need to:

  • have your password ready

  • know the section and, if applicable, the item you want to retrieve.

Here's an example of an API request in URI format:

https://api.careers.govt.nz/v2/{section}
or
https://api.careers.govt.nz/v2/{section}?{item}

Where the field:

  • section = pageType or controller (jobs or industry)

  • item = data parameters

Updated 9 Sep 2015