Skip to main content

Takapuna office closure | Takapuna office closure. The Takapuna office is relocating to a new address so will be closed from 22 November 4pm to 26 November 4pm. From 27 November you can find the new office at: 74 Taharoto Road Smales Farm, One NZ Building, Takapuna.

Some services unavailable 23 - 24 November | myIR, gateway services and our self-service phone line will not be available from 3pm Saturday 23 November to 9am Sunday 24 November while we do planned system testing. This will not affect any tax entitlements or payments scheduled during this time.

Response status codes

The response message from gateway services always includes a status code and status message. This describes how successfully the gateway service call was carried out.

Following the status code and message will be the element which will return the operation's response. We use this form of response even for errors, rather than using SOAP faults.

There are two categories for framework level security validation for services and operations. This impacts where and when status codes 4 and 7 will be returned.

Account level validation

Services where there will always be an account type required will validate the account type as part of the framework level validation.

Customer level validation

For services where the account type is not required, the framework will be set up to always do customer level validation only.

Any issues with the account type will not be reflected in codes 4 or 7, but only by specific codes of 100 or above.

Different service operations may apply permissions at different levels.

More information

You can view and download the operations, schemas and data definitions for each service in our services catalogue.

Services catalogue

Last updated: 28 Apr 2021
Jump back to the top of the page