Skip to main content

COVID-19 - Level 1 If you've been affected by COVID-19, we may be able to help. Find out more

Gateway and file upload services

The gateway services are generally available 24 hours a day, 7 days a week, other than approved scheduled changes. These can usually be accommodated without taking down the system.

If maintenance is needed, it will take place weekly on a Sunday between 12am and 4am.

Gateway and file upload services catalogue


If there's an unscheduled outage, we'll contact digital service providers using the service. 

Service providers who have deployed integrations with our production environment for gateway services can monitor the services' status within the developer portal, along with metrics of their service activity.

If you find a service is not working correctly, you can email GatewayServices@ird.govt.nz

E-File

E-File services are also generally available 24 hours a day, 7 days a week, other than approved scheduled changes. These can usually be accommodated without taking down the system.

Any maintenance will take place on Sundays between 12am and 12pm .

Test environment

If you want access to our test environment, email GatewayServices@ird.govt.nz to check the testing times available. Contact us as soon as you start any development that will need testing.

If a service is not working correctly

If you find a service is not working correctly, you can email us and we'll respond within 5 working days, depending on the complexity of the issue.

Email GatewayServices@ird.govt.nz with:

  • your name and contact phone number
  • a description of the problem and/or symptoms
  • screenshots of what you see
  • any other supporting information, for example error messages or response scripts.

Maintenance schedule

Download a maintenance schedule showing the availability of our gateway, myIR file upload and E-File services.