Use this repository to access software development kits (SDKs) for returns and information services offered through Inland Revenue's gateway services. They all use the Return service.
AIM is a provisional tax option that uses accounting software to work out how much provisional tax small businesses will have to pay throughout the year.
GST is a 15% tax added to the price of most goods and services in New Zealand, including imported goods and services. Anyone registered for GST must file returns.
Organisations can use this service for Income Tax (INC) returns and Donation Tax Credit (DTC) forms through the Return Service including
- submit new or amended INC return or DTC form
- request income tax information held by us for a customer
- query the processing status of a previously filed INC return or DTC form
- request a copy of a previously filed INC return or DTC form
- request the due date of the next expected income tax return
- Investment income reporting through gateway services lets organisations securely file investment income information, amend a previously filed return and retrieve a return status or return data.
- It is available for the withholding tax product types - Approved issuer levy (AIL), Dividend withholding tax (DWT), Interest pay as you earn (IPS), Non-resident withholding tax (NRT), Resident withholding tax (RWT) and Portfolio investment entities (PIE) attributed income tax
Payday filing through our gateway services lets employers:
- file employment information (EI) to us each pay cycle instead of monthly using the Return service
- send changes to employee details (ED) using the Employment service.
The Push Notification service
- provides notification of change to the status of a return via a secure file transfer service
- is intended to be used by software providers where large quantities of return status data is required.
- Gateway Services - Customer and Accounts
- Gateway Services - Communication
- Gateway Services - Calculators
- Gateway Services - Access
- Gateway Services - Transaction Data Services

