Essential reading: 

Essential Information

A web conference in late 2017 was recorded and is available in our public dropbox. Please download either the Audio or the Video recording to find out more about ACC's direction with APIs.   



Please visit the forum if you would like to place feedback or comment.



ACC processes are currently packaged as a series of online "interactions". In most cases, the complete set of "interactions" needs to be available to the Provider, & their support team, for them to most effectively assist the patient.

ACCs move to APIs initially does not alter those "interactions", it replicates them. This provides parties the opportunity of an initial reasonable impact step change.

Given time, ACC will change its processes; such change will be solely built using these APIs. Other solutions will be phased out for reasons such as the technology-base has reached end-of-life.

Supporting SNOMED codes submitted in claims, medical certificates, & change of diagnosis is a case in point. ACC has invested in these APIs to support SNOMED codes; legacy systems will not be invested in.


A view from your user’s perspective

The series of standard "interactions" ACC uses to manage information between Providers (& their Practices / DHBs) & itself, are:


1. Claim – Initial interaction regards a patient injury the Provider believes ACC will cover. This interaction also empowers:

a. The Provider to refer the patient to other Providers (e.g. x-rays & / or physio’s) to undertake work that will assist with diagnosis & / or recovery

b. A subset of Providers (Medical Practitioners) to advise a level of fitness for work of less than 100% which then results in authorisation of weekly compensation for the first week by the employer & the second week by ACC.


2. Medical certificate – Secondary interaction (linked to Claim) if:

a. A patient:

i. Needs time off work beyond the first two weeks;

ii. Needs additional support to operate in life or getting to / from work;

iii. Presents additional complications that need to be considered;

b. The Provider:

i. Has an update to their diagnosis;

ii. Needs extra support services to assist with diagnosis.

Important Note: The Claim, Medical Certificate, & Change of Diagnosis are also crucial standard "interactions" for the Patient; providing a document for their record &, as appropriate, a document for their employer (or other third party) advising of their circumstances.


3. Change of Diagnosis – Secondary interaction (linked to Claim):

a. Add – While treating your patient, maybe in a follow up visit, you find another injury that relates to an initial claim.

b. Update – A patient referred by one Provider to another (say a GP to a physio) can result in a more accurate diagnosis being obtained; this needs to be submitted.

c. Delete – While treating your patient, maybe in a follow up visit, you realise that the initial diagnosis is incorrect.


4. Invoicing– Mechanism to receive invoices from Providers for ACC funded diagnosis & / or treatment (linked to Claim).


5. Query Claim Status– Ability for the Provider to see whether the claim has been accepted & what are the latest diagnoses if other Providers have been referred to.


6. Query Invoice / Payment status- Ability for the Provider / Practice to see whether invoices for the claim, or secondary interactions, have been paid.