Make a payment
Software providers Kaiwhakarato Pūmanawa Rorohiko

Relationship services

Find out how to build software that supports managing client and software relationships in our gateway services and the management of myIR user roles.

Inland Revenue provides a range of relationship services that can be used by Software Providers and Business Intermediaries (such as a tax agent, bookkeeper, payroll bureau, payroll intermediary) to manage clients.

The relationship services listed here are important for defining the relationships between entities.

Relationship name Functions Channel provided
Software Intermediation Service
  • Links, delinks and lists a business intermediary client list to TDS software intermediary customer - view details
  • Links and delinks an organisation account to a TDS software provider - view details
Gateway Services only
Intermediation service
  • Links, delinks and updates a business intermediary client list with a customer account
  • retrieves clients and client lists that have already been established
Gateway Services and myIR
Identity and Access Service
  • Records the myIR users consent for IR to send data to a Software Provider via a Gateway Service - view details
  • Informs IR of the identity of a valid myIR user (through a token) - view details
Gateway Services only
Client list creation
  • Setting up of a business intermediary client list
Secure mail (myIR)
myIR user roles
  • Creation of a myIR login for an operational role (e.g. TDS, KiwiSaver, IIR) - view details
myIR delegation management
  • The delegation management within a business intermediary for access to customer in their client lists