Skip to main content

myIR maintenance | myIR will not be available on Sunday morning 10 December from midnight to 4am NZDT. We're sorry for any inconvenience.

End-of-year arrangements Our offices and phone lines will close down over the holiday season, but our website, self-service 0800 number and myIR will remain available. Find out more

We've upgraded our voice system You may notice some changes the next time you call us. Find out more

View and download the investment income reporting software developer kits to access:

  • the schema (XSD) and supporting WSDL for the return service
  • sample messages for each service operation - requests and responses
  • mock environment information including test scenarios, mind map and test data
  • test environment information including test scenarios and mind map
  • the investment income information return service build pack that includes data definitions of each operation response status code definitions.

All SDKs are on GitHub.

Approved issued levy (AIL) software developer kit (SDK)

Dividend withholding tax (DWT) software developer kit (SDK)

Interest pay as you earn (IPS) software developer kit (SDK)

Non-resident withholding tax (NRT) software developer kit (SDK)

Resident withholding tax (RWT) software developer kit (SDK)

Portfolio investment entities (PIE) attributed income software developer kit (SDK)

Use the Getting started guide to find out how to access our sandbox (mock services) and test environments.

Getting started guide

Supporting services

Identity and access service

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