1 PRIMHDInformation Support - PRIMHD

Welcome to the Regional Information Support - Programme for the Integration of Mental Health Data (PRIMHD) page.

Here you will find the latest updates relating to PRIMHD and information to assist you to reporting within your services.  For any further information or support please click here to contact Belinda Walker.


KPI Programme Mental Health & Addiction Aotearoa New Zealand

The Key Performance Indicator (KPI) Programme is a mental health and addiction sector owned and led initiative that facilitates continuous service quality improvement across all DHBs and their NGO partners through collective data analysis and benchmarking, learning and problem solving. ​

Since 2007, the Programme has built a knowledge base which provides a platform from which the Government and services across Aotearoa can monitor changes to the mental health and addiction system both locally and nationally, in alignment with Government policies and priorities.

You can register for entry and once approved you gain access to the data.

A new NGO indicator has been added in relation to continuity of care showing the level of engagement NGOs have with people admitted to an Acute Inpatient Unit.

    • contacts with an NGO 28 days prior to admission.
    • contacts during admission.
    • contacts 8 days after discharge; and
    • no NGO referral or involvement.

If you are interested, then you can register at

MH&A KPI Programme – KPIs for the NZ Mental Health & Addiction Sector (mhakpi.health.nz)


Mental Health and Addiction: Service Use web tool now available

  • The information included in this tool is from DHB and NGO PRIMHD data for the financial years from 1 July 2012 to 30 June 2021
  • Included are
    • Demographic and geographic information,
    • client referral pathways,
    • the types of services provided,
    • supplementary consumer records,
    • diagnosis information
  • The web tool allows you to select areas of interest and down the related data.
  • The tables do not include information on:
    • the provision of primary mental health care
    • problem gambling
    • people with a mental health condition who do not access services.

View the Mental Health and Addiction: Service Use web tool


Te Manawa Taki PRIMHD contact data

The following graphs show contacts recorded over the last five financial years for each of our DHB areas. There are separate graphs for DHB and NGO data. Per 100,000 population has been used as this is a better representation of the percentage of the population for the different demographics e.g., ethnicity. The data source is PRIMHD collection as at 07/05/2022.

Key points for Te Manawa Taki

  • Overall, there has been both a volume decline and delays in reporting PRIMHD data
  • Waikato DHB data being the least up to date and with a drastic dip for Quarter 2 and Quarter 3 of 2021/22
  • Comparing contacts from 2020 to 2021 we see a 13% decrease in numbers.
  • The proportion of face-to-face contacts has decreased from 70-73% over the period 2013-2019 to 63% in 2020 and 65% in 2021.
  • In our region DHBs tend to see more 15–29-year-olds whilst NGOs see more people ages 30–64-year-olds
  • Māori youth aged 15-29 years received the greatest number of mental health and addiction contacts by both DHB and NGO since July 2019


Zero seclusion-safety and dignity for all

The Health Quality and Safety Commission’s collaborative work on this with the DHBs and Te Pou continues and, as Minister Little shared our reports show promising signs with up to nine DHBs achieving zero seclusion at some point, and five of those achieving zero seclusion for 6 months or more. There are signals of improvement (runs, shifts, trends) in the data of 70% of the DHBs. Even spikes in seclusion due to the Covid-19 impacts are being seen to move quickly downwards again to the levels prior to Covid-19. We are also seeing a faster decrease in Māori seclusion (therefore positively impacting inequity). This comes from the most up to date PRIMHD data available.

We have just published our Zero seclusion ‘Change Package’ related to this work on our website:  


This is a collection of a clinical bundle, a cultural kete and other resources which comprise the practice-based evidence of how to further reduce and eliminate seclusion.

It summarises much of what we have learned over the four years-plus so far and should be a really useful resource for the DHBs.


Updates from PRIMHD National Stakeholder Group hui May 2022

  • HONOS (Infants) is being introduced soon. Plan and comms coming soon from Te Pou / expert group.
  • Family / Whānau Indicator date to become mandatory has moved to 1 July 2023. Really critical that all providers are on board by then.
  • Concerns were raised about sector system changes and how these choices are best made to align regional / national priorities.
  • Concerns about incomplete data overall for 2021/22 period. DHBs have been contacted where inconsistencies occur.
  • Outcomes Trainings coming up in June (HoNOS) and Adom (November) via Te Pou Events website. Events | Mental health and addiction | Te Pou
  • Goal to improve collection and quality of diagnosis data


PRIMHD Wait times

You will remember that as mental health and addiction providers your data was analysed at to see if new people referred to services received a clinical face-to-face contact within 3 or 8 weeks.

The Ministry of Health have changed their focus in wait times to improving access for tamariki and rangatahi.

PRIMHD Code Training

Due to Covid restrictions PRIMHD training is occurring via Zoom or Microsoft Teams. Whilst this is not as ideal as being present with you, it is a good alternative. I understand how busy everyone is now, so I am happy to train people one at a time if that helps with not taking people off the frontline all at once.
If you would like more support with any of the following,

  • PRIMHD code use
  • PRIMHD data feedback
  • PRIMHD Mapping Documents – you need to update these annually
  • General PRIMHD questions
  • Are you using the right codes in the best way?
  • Can we get some graphs on what we are submitting?
  • Do you have a PRIMHD training need?

Please contact me: Belinda Walker, Ph: 027 247 6440
email: Belinda.walker@healthshare.co.nz


PRIMHD DocGuide to PRIMHD Activity Collection & Use - Update

The purpose of this guide is to improve national consistency in the collection and use of mental health and addiction activity data in PRIMHD. This includes the activity type codes, also known as T codes, and the family/whānau indicator added to PRIMHD on 1 July 2021. The guide is not a replacement for the HISO PRIMHD standards but is intended to support a consistent national approach so that the quality of the data reported to PRIMHD improves, thereby improving the utility of the national collection


* * * * * * * * * * * * * * *


Every year the Ministry of Health look at the PRIMHD data collection set and make changes to try to stay up to date with the sector as much as they can.

As of the 1st of July 2021, there are several changes occurring which you need to be aware of and may need to discuss with your service provider if you are submitting your data through a vendor.

If you are confused about any of the following, please contact me at Belinda.walker@healthshare.co.nz  or phone 027 247 6440.

* * * * * * * * * * * * * * *

CodeChanges to Referral From and To Codes

  • JU – updated definition – Justice court or youth justice
  • CR – new code – Corrections – Corrections service or prison
  • CO – new code – Court Liaison Service i.e. referrals for court reports
  • FO – new code – Forensic Community i.e. any forensic community service

* * * * * * * * * * * * * * *

Code1New Activity or T Code

  • T51 – Integrated Pacific and Clinical Interventions Pacific specific with clinical medical model
  • T52 – Health Coaching - Health coaching provided to support clients to manage and maintain their own health and wellbeing as a component of the Access and Choice Integrated Primary Mental Health and Addiction (IPMHA) services. 

For PRIMHD purposes, these must be delivered by people who have received Health Coach training.

To be used by Integrated Primary Access and Choice teams only.

* * * * * * * * * * * * * * *

TransferReferral End Code – When you discharge or transfer someone.

  • DR – Changed comment – Ended routinely. Completed treatment/programme/goals/assessment.
  • DT – Changed description – discharge to another healthcare facility that is not a mental health or addiction service (Use DK for transfers to another NGO that provides mental health & addiction services)
  • DZ – new code – Routine discharge – no face-to-face contact is required e.g. information or advice given only
  • DY – new code – Transfer to another mental health & addiction service within your organisation
  • DK – new code – Discharge to another NGO that provides mental health & addiction services.

* * * * * * * * * * * * * * *

Gender 1Gender Diversity

The NHI records Gender Identity, but some systems capture the attribute using a field labelled ‘Sex’.  The concept of Sex and Gender Identity are different. The National Collections will continue to collect sex for all events excluding PRIMHD which will accept the NHI gender code set. DHBs are required to update gender on the NHI and report sex to the National Collections (excluding PRIMHD).

Add O Gender Diverse (Other Gender) to the list of available NHI gender categories.

* * * * * * * * * * * * * * *

Family WThe new family/whānau data element. 

The family/whānau involvement (FWI) flag indicates whether a family/whānau member was involved with the tangata whaiora at an activity. A yes (Y) or no (N) indicator now applies to each relevant T code.

To indicate involvement as yes (Y) whānau should have been involved for all or part of an activity.  Involvement can be interpreted broadly based on each scenario and each service user – for some people or activities it may just be the presence of whānau in the room while for other people or activities whānau may be as actively involved as the service user.

Logo Line

New Contact and Team Codes

Ministry updates of PRIMHD effective 1 July 2020. There are a few you will need to be aware of and also may need to contact your vendors or patient management system people (if you have them) to let them know and allow you to enter contacts to new codes and teams;

  • Addition to sex codes 
    • O =  Gender Diverse
  • New Team Type for Intellectual Disability for DHB provider arm
  • New Activity Type for Integrated Pacific and Clinical Interventions - T51
  • New Referral From and Referral To codes
    • OL = Older persons community mental health services – referral from and to
    • AC = Access and Choice General Practitioner (GP) Teams – referral from only
  • Retire one Referral From and Referral To code
    •  OP - Psychiatric outpatients is being removed
  • Update two Comments for descriptions for Referral From and Referral To codes
    • PI = Psychiatric inpatient will be for adult and older persons inpatient units
    • SW = officially changing from being described as Social Welfare to Government social welfare e.g. MSD (Ministry of Social Development), Work and Income, Oranga Tamariki.

Full details are available at:

3 things not recover


PRIMHD Reporting

The purpose of PRIMHD is to capture the journey of the tangata whaiora and their family/whanau within services through numbers and codes NOT keeping track of staff hours.

I acknowledge that at times the reporting of data can be time-consuming, but is a requirement from the Ministry of Health and has to be done efficiently within timeframes. This should be viewed as an opportunity to reflect how well your service is making a positive difference to the lives of the people we serve.

Quick Reminder

It is a requirement for mapping documents to be updated to reflect changes in your organisation including minor changes i.e. address, staff members joining and leaving, new and exited teams, and not when changes come through from the MoH. This helps to keep organisational contractual details current. Once updates are completed these should be sent directly to the MoH.


NCAMP Changes to the National Collections

The changes to the national systems effective from 1 July 2019 affect the National Minimum Dataset, National Booking Reporting System, the National Non-Admitted Patient Collection and the Programme for the Integration of Mental Health Data.

Some revisions have been made to the requirements for when SCR records are expected to be reported to PRIMHD. The reporting guidelines “Guide to PRIMHD supplementary consumer record (SCR) requirements including social outcome indicators v1.3” have been updated to state that we don't expect an SCR to be reported until there have been 3 face to face (FTF) activities. This is in line with the “DHB non-financial monitoring framework and performance measures” specifically Policy Priorities PP7 –“Improving mental health services using wellness and transition (discharge) planning”.

Additionally, depending on contracted services they provide, some organisations are not required to report SCR records to PRIMHD.

This means that the revised guidelines (v1.3) differ with the current PRIMHD business rules (which say MoH expects an SCR 91 days after the first FTF activity).

Organisations may still receive warnings about SCR data not being supplied, even when the service is exempt for SCR reporting, or where a service user has not had three face to face activities.  A future NCAMP change to align the PRIMHD business rules to the revised SCR guidelines is being investigated. In the meantime, it is proposed that the text of the following three response messages is adjusted to alert organisations to the fact that the warning about lack of SCR data may not necessarily apply.


PRIMHD Mapping Documents

The Ministry of Health have a new template for PRIMHD Mapping Documents. If you have had changes as per below, it is now time to think about updating your document.  I am happy to support you with this.

Changes that would suggest you need to update your Mapping Document;

  • Contracts – new ones, different Purchase Unit Codes (PUCs), ended contract lines
  • Address you deliver services from
  • PRIMHD teams that need closing
  • New PRIMHD teams that you require
  • Additional codes required
  • Key contact people have altered

Data entry – there seems to have been a slow down for some providers in entering their data. This means that it appears to the Ministry of Health that you have either not had contact with people or that you have less contact than usual. It is really important that we reflect the need in our communities and one way of doing this is having accurate and timely evidence through data. I urge you to ensure that you keep up to date, or if there is a problem, please contact me or the Ministry of Health so we can support you. It is better to be up front, so a way forward can be found.


Wait Time Targets

The Minister of Health has set access targets that must be met by both DHBs and NGOs – that is the time between, when a referral is received and when the first face to face visit with the client occurs. This applies to ‘new’ clients, the Ministry of Health’s main focus is on Child and Adolescent and/or AOD teams.

A report is sent to funders within DHBs each month identifying the wait times, where targets are not being met, services maybe held accountable? It is imperative that all PRIMHD data is reported accurately as reports are filtered from PRIMHD data.

Key points to note:

  • New client definition: For the purpose of this report, any client that has not been seen by any other MOH/DHB funded mental health and addiction provider within 12 months.
  • Calculation: Access rates are calculated from the time a referral is received by a provider until the first face to face contact is logged in PRIMHD.
  • Discharge: If the client DNAs several times and needs to be discharged - use referral end code DM. The client will continue to appear on the list if exited using any other referral end code.
  • Referral start: If the client is referred by Justice whilst they are still in prison, then the referral start date should be logged as the release date into the community and NOT when the referral was received.