Alert icon

CV Builder will no longer be available after 18 September 2025. Please note: users won’t be able to log in to their accounts from 3pm 18 September to 3pm 19 September.

For more information, visit our info page.

How to get an API of our job profile content

Find out how to access job and industry information through the careers.govt.nz API (application program interface).

Important update

  • The careers.govt.nz website and Jobs API are being replaced with a new careers planning website and a new Occupations API.
  • Tahatū Career Navigator is the next generation of the current careers.govt.nz website, profiling nearly 100 school subjects, over 4,000 qualifications and more than 800 career ideas.
  • The careers.govt.nz website will be decommissioned in early December 2025.
  • If you already have access to the careers.govt.nz API, you’ll be able to continue using it until the website is decommissioned in early December 2025. We have reached out directly to current API users about the transition to the new Tahatū API.
  • As the careers.govt.nz website will soon be decommissioned, we recommend current and new API users apply for the Tahatū Occupations API. For more information and to request access, visit Tahatū Occupations API
  • For more information about Tahatū Career Navigator, please visit the Tertiary Education Commission website.

What does the API give you?

The careers.govt.nz jobs and industries application programming interface (API) lets you access information about more than 400 types of jobs in New Zealand.

Job information on careers.govt.nz 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.

Pay, entry requirement and job opportunity information is specific to New Zealand, so this API isn't suitable for other countries.

Accessing the API

To get access to the API:

  1. Go to our contact page.
  2. Select 'Request for API access' as the subject.
  3. Send us a message telling us why you'd like the API, and the website you'd like it for.
  4. We will assess your request.
  5. We may send you a Memorandum of Understanding to sign and send back.
  6. After this, we may grant access to the API.

Note: To use the API, you will need an account on careers.govt.nz.

 

Formats supported

The careers.govt.nz API only supports JavaScript Object Notation (JSON) response format.

Creating an API request

To make an API request, you’ll need to 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 3 Sep 2025