Skip to main content

Tahatū Career Navigator Occupations API

Version: 1.0

Purpose​

The Occupations Application Programming Interface (API) on Tahatū Career Navigator provides access to detailed data in the ‘Explore career ideas’ section of the website for the 800+ jobs on Tahatū, including general descriptions, tasks and pay data.

Endpoints​

The API includes the following endpoints:

GET /info: retrieve metadata about the API. 

GET /occupations: retrieve a list of occupations. 

GET /occupations/id: retrieve details of a specific occupation by ID. 

GET /occupations/search: search for occupations based on titles and descriptions. 

How to apply for the Occupations API​

To apply for approval and key access to the Tahatū Occupations API, please email TEC at:

tahatu@tec.govt.nz

Please use the subject heading ‘Occupations API access’ in your email.

Explore Schema​

You can explore the schema here

Download Schema​

You can download the OpenApi schema here