Skip to main content

Offices closed All Inland Revenue offices are currently closed to the public to help limit the spread of COVID-19.

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

View and download the AIM software developer kit (SDK) to help you integrate:

  • test scenarios
  • test data
  • sample messages for each service operation - requests and responses
  • the schema (XSD) and supporting WSDL for the return service
  • the identity and access authentication flow and sample curl commands
  • the return service build pack for AIM to view data definitions and response status code definitions.

AIM software developer kit (SDK) on GitHub


Use the Getting started guide to find out how to access our sandbox (mock services) and test environments.

Getting started guide

Supporting services

Identity and access service