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.

Register
Search tips
For software providers

Gateway services are available over the internet with endpoints documented for each individual web service.

JSON API communication standards

Aspect Standard/protocol Version
Transport protocol HTTPS HTTP 1.1
Transport layer encryption TLS 1.2
Access tokens OAuth or client signed JWT 2.0

Development versions of JSON APIs are provided with YAML (Open API) documentation.

SOAP web services communication standards

Aspect Standard/protocol Version
Message envelope SOAP 1.2
Service contracts WSDL 1.1
Operation identification WS-Addressing 1.0
Transport protocol HTTPS HTTP 1.1
Transport layer encryption TLS 1.2
Access tokens OAuth 2.0

Development versions of WSDL contracts and schemas are provided with service documentation. Those hosted with the web service are too generic to allow test or code generation.

All message requests made to us must include both:

  • a SOAP header
  • the WS-Addressing 1.0 action element identifying the operation namespace (shown in sample requests).

Tasks

Topics

Other Sites

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