Skip to main content

North Island flooding | Many of you have been affected by the flooding in the North Island and may need help keeping up with your tax obligations. Find out more

Inland Revenue Inland Revenue
  • About us
    • About us
    • IR careers
  • News
    • Media releases
    • Updates
    • Subscribe
    • Seminars
  • Related Websites
    • Tax Technical
    • Tax Policy
    • International
  • Contact us
    • Contact us
    • Media queries
    • Tax Technical queries
    • Tax Policy queries
  • English
Register myIR login
myIR login
Individuals and families Ngā tāngata me ngā whānau
  • IRD numbers Ngā tau IRD
  • Income tax for individuals Te tāke moni whiwhi mō ngā tāngata takitahi
  • File my individual tax return Te tuku i tētahi puka tāke takitahi
  • Support for families Ngā tautoko i ngā whānau
  • KiwiSaver Poua he Oranga
  • Student loans Student loans
  • Self-employed Mahi ā-kiri
  • More... Tāpiri atu…
Business and organisations Ngā pakihi me ngā whakahaere
  • Income tax Tāke moni whiwhi mō ngā pakihi
  • Employing staff Te tuku mahi ki ngā kaimahi
  • KiwiSaver for employers Te KiwiSaver mō ngā kaituku mahi
  • Goods and services tax (GST) Tāke mō ngā rawa me ngā ratonga
  • Non-profits and charities Ngā umanga kore-huamoni me ngā umanga aroha
  • International Tāwāhi
  • More... Tāpiri atu…
Intermediaries and others Ngā takawaenga me ētahi atu
  • Tax agents Ngā māngai tāke
  • Bookkeepers Te kaikaute
  • PAYE intermediaries Ngā takawaenga PAYE
  • Payroll bureaus Ngā tari utu ā-rārangi
  • Digital service providers Ngā kaiwhakarato pūmanawa rorohiko
  • More... Tāpiri atu…
About us
  • About us
  • IR careers
News
  • Media releases
  • Updates
  • Subscribe
  • Seminars
Related Websites
  • Tax Technical
  • Tax Policy
  • International
Contact us
  • Contact us
  • Media queries
  • Tax Technical queries
  • Tax Policy queries
English
Register
myIR login
Inland Revenue
Home
Individuals and families Ngā tāngata me ngā whānau
Popular pages Ngā wharangi rongonui
Cost of Living Payment Utu mō te utu oranga IRD numbers Ngā tau IRD File my individual tax return Te tuku i tētahi puka tāke takitahi Support for families Ngā tautoko i ngā whānau Managing my tax Te whakahaere i taku tāke
More individuals and families
Familes Ngā whānau
Working for Families Working for families Child support Te tautoko tamariki Paid parental leave Te utu tiaki pēpi
Property and Trusts Ngā wharangi rongonui
Trusts and estates Ngā rōpū kaitiaki me ngā rawa tuku iho Property Ngā rawa
Individuals Ngā tāngata
Income tax for individuals Te tāke moni whiwhi mō ngā tāngata takitahi Non-residents Ngā kainoho-tāwāhi Self-employed Mahi ā-kiri Kiwisaver for individuals Kiwisaver mā te tangata takitahi Student loans Ngā pūtea taurewa ākonga Cryptoassets for individuals Ngā rawa whiti-rangi mā te tangata takitahi Unclaimed money
Situations Ngā āhuatanga
I am going overseas Kei te haere ahau ki tāwāhi I received an income tax assessment I whiwhi i ahau tētahi aromatawai tāke moni whiwhi I'm struggling to file and pay my tax
More situations
Business and organisations Ngā pakihi me ngā whakahaere
Popular pages Ngā wharangi rongonui
Covid-19 Businesses and organisations KOWHEORI-19 Ngā pakihi me ngā whakahaere File a companies income tax return - IR4 Te tuku i tētahi puka tāke moni whiwhi kamupene - IR4 Not-for-profits and charities PAYE calculator to work out salary and wage deductions Property Ngā rawa IRD numbers Ngā tau IRD
More business and organisations
Income tax Te tāke moni whiwhi
Types of business income Ngā momo moni whiwhi pakihi Tax rates for businesses Ngā pāpātanga tāke mō te pakihi Balance dates Ngā rā mutunga tau pūtea
GST Tāke hokohoko (GST)
Charging GST Te uta i te tāke hokohoko Claiming GST Te kerēme tāke hokohoko
Employing staff Te tuku mahi ki ngā kaimahi
Register as an employer Te rēhita hei kaituku mahi Paying staff Utu kaimahi Payday filing Te tāpaetanga rā utu Deductions from income Ngā tangohanga mai i ngā moni whiwhi Kiwisaver for employers Te KiwiSaver mō ngā kaituku mahi
International Tāwāhi
International tax for business Te tāke aowhānui mō ngā pakihi
Situations Ngā āhuatanga
I am starting a new business Kei te tīmata au i tētahi pakihi hou I am going to employ someone Kei te tuku mahi ahau ki tētahi tangata My business is making a loss Kei te hapa taku pakihi
More situations
Intermediaries and others Ngā takawaenga me ētahi atu
Intermediaries Ngā takawaenga
Becoming an intermediary Te tū hei takawaenga Getting authority to act Te whiwhi whakamanatanga Executive office holders Ngā kaipupuri tūnga whakahaere Linking client accounts Te honohono pūkete kiritaki Nominated person Te tangata kua whakaingoatia Tax pooling Te whakarōpū tāke Gateway services
More intermediaries and others
Tax agents Ngā māngai tāke
Agents answers Ngā Whakautu Māngai Tax agent status Te tūnga māngai tāke Extension of time arrangements Te whakaroa i ngā whakaritenga wā Managing consolidated groups Te whakahaere rōpū tōpū Income tax for individual clients of tax agents Te tāke moni whiwhi mā ngā kiritaki takitahi a ngā takawaenga News updates for tax agents
More tax agents
Digital service providers Ngā kaiwhakarato ratonga matihiko
Getting started guide About the developer portal Mō te tomokanga kaiwhakawhanake Gateway services architecture Te hanganga ratonga tomokanga Services catalogue Te putumōhio ratonga
More digital service providers
Roles Ngā tūranga
Tax agents Ngā māngai tāke Bookkeepers Ngā kaikaute PAYE intermediaries Ngā takawaenga PAYE Payroll bureaus Ngā tari ripanga utu kaimahi Other representatives Ētahi atu māngai
Search tips

Te tāke moni whiwhi mō ngā kaiwhakarato ratonga matihiko Income tax for digital service providers

For software providers
For software providers
  • Services catalogue
    • Returns and information
      • Accounting income method (AIM) for digital service providers
      • Goods and services tax (GST) for digital service providers
      • Donation tax credits for digital service providers
      • Income tax for digital service providers
        • Income tax software developer kit
      • Investment income reporting for digital service providers
      • Payday filing for digital service providers
      • Push notifications
      • Unclaimed money holder reporting

Everyone in New Zealand needs to pay tax on income they earn, whether they’re an individual, business, or organisation.

If you have any questions about income tax or using gateway services for income tax, email [email protected]

Income tax returns

Most salary and wage earners will automatically receive an income tax assessment and will not need to submit a return, but any individual who does not receive an automatic assessment, and all businesses and organisations, must submit an annual income tax return unless they have an exemption.

Income tax information is submitted to us on one of these return types:

  • IR3 - Individual income tax return - resident
  • IR3NR - Individual income tax return – non-resident
  • IR4 - Companies income tax return
  • IR6 - Trust or estate income tax return
  • IR7 - Partnership or look-through companies income tax return
  • IR8 - Māori authority income tax return
  • IR9 - Clubs and societies income tax return
  • IR44 - Registered superannuation fund income tax return
  • IR1215 - Income tax return and disclosure - as agent

When submitting an income tax return the filer is also able to provide additional forms (attachments) that apply to the individual’s or organisation’s situation.

Find out more about the income tax forms available through gateway services in the income tax software developer kit.

Income tax software developer kit (SDK) on GitHub 

Filing income tax returns through our gateway services

The income tax gateway service can be used to:

  • submit new or amended income tax returns and supplementary forms
  • request income tax information held by us for a customer
  • query the processing status of a previously filed income tax return
  • request a copy of a previously filed income tax return
  • request the due date of the next expected income tax return.

All income tax returns and supplementary forms are supported by the income tax gateway service.

Gateway service capability for income tax

The gateway service used for income tax is the return service. It provides the following capabilities through defined service operations:

Service operation Description
Prepop Provides information in pre-populated fields.
File Submits new or amended income tax returns.
RetrieveStatus Provides the status of a previously filed income tax return.
RetrieveReturn Provides a copy of previously filed income tax return.
RetrieveFilingObligation Provides the due date of the next expected income tax return.

Income tax business use cases

The following are examples of sequences of the gateway return service operations that could be used to achieve a specific business outcome.

Keys

  • Gateway service operations: RS = Retrieve Status, RR = Retrieve Return, RFO = Retrieve Filing Obligation
  • The numbers for each use case are the order in which these operations should be called when using this services.
Use case Gateway service operation
File Prepop RS RR RFO
1. Submit a new income tax return 2 1
2. Retrieve the status of a previously submitted return and next filing obligation 1 2
3. Retrieve previously submitted income tax return 1
4. Amend and submit an income tax return 2 1

Automatic assessment (auto-calc) business use cases

We'll calculate assessments automatically for individuals if we have all their income information for the tax year. We'll recalculate those assessments if the income information is later updated. The income tax gateway service can be used to view and manage automatically calculated assessments.

Income tax assessments (auto-calc)


The following are examples of sequences of the gateway return service operations that could be used to achieve a specific business outcome.

Keys

  • Gateway service operations: RS = Retrieve Status, RR = Retrieve Return, RFO = Retrieve Filing Obligation
  • The numbers for each use case are the order in which these operations should be called when using this services.
Use case Gateway service operation
File Prepop RS RR RFO
1. Retrieve auto-calculated return   2 1
2. Confirm auto-calculated return 3 2 1
3. Amend and submit reportable income 2 1  
4. Submit other income 2 1


Pages in this section
  • Income tax software developer kit View or download the income tax software developer kit.

Tasks

  • Getting started guide

Topics

  • Income tax for businesses and organisations
  • Income tax for individuals

Other Sites

  • Log in to the developer portal
  • Register for the developer portal

Moving between Inland Revenue sites

picto--truck

Heads up. We're taking you to our old site, where the page you asked for still lives

Continue to old site
Last updated: 28 Apr 2021
Jump back to the top of the page top
Inland Revenue Inland Revenue

FOLLOW US

  • Facebook
  • Twitter
  • Youtube
  • LinkedIn
  • Subscribe

CONTACT US

  • Contact Information
    • Contact us
    • Media queries
    • Tax Policy enquiries
    • Tax Technical enquiries
  • About us
  • Careers
  • International
  • About the site
  • Conditions of use
  • Privacy
  • Glossary
  • Accessibility
  • Copyright
  • MyIR Help
© Copyright 2023 Inland Revenue
New Zealand Government
Shielded website