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.

Transaction data services (TDS) is a business service which provides customer financial transaction data to be used by software packages.

Our customer financial transaction data includes amounts assessed and associated credits or debits. No sent data is associated with the details of how an assessment has been calculated.

You'll need to comply with our information disclosure policies to use these services.

Information disclosure

About transaction data services 

The TDS service is made up of three application programming interfaces (APIs):

  • financials
  • summary
  • transactions.

The three APIs are built to support two distinct models, the real-time model and the data reconciliation model. Each API has its own security model. 

Real-time model

This model is for real-time users. It allows digital service providers to build applications that use gateway services to retrieve data on demand. The real-time user of the application initiates the request to gateway services.

This model requires two APIs, TDS financials and TDS transactions. 

Data reconciliation model

This model is for bulk data feed users. Digital service providers using this model can copy financial and transaction data from us into their own database, which is then used by their applications.

This model requires two APIs, TDS summary and TDS transactions. 

For access to myIR File Upload and Gateway Services detailed technical documentation, register your organisation or login to Gateway Customer Support Portal using the links below.

Last updated: 28 Aug 2024
Jump back to the top of the page