ExceptionsVersion: 9.9.7
Exceptions returned by the ABN Lookup web services fall into a number of categories:
-
http errors such as:
- Page not found (404)
- Internal server error (500)
-
Application errors such as:
- Invalid ABN number
- No records found
- Timeout
- Too many records found
- Unrecognised user
If an Application error occurs, the payload will contain an exception consisting of an exceptionCode and an exceptionDescription. Codes and descriptions that may be returned include:
| Code | Description examples |
|---|---|
| SEARCH | No records found |
| WEBSERVICES | System problems have prevented this request from completing |
| WEBSERVICES | Object to be transformed was not recognised - i.e not a Party, SearchResult or Request |
| WEBSERVICES | The Include History flag must be 'Y' or 'N' |
| WEBSERVICES | The GUID entered is not recognised as a Registered Party |
| WEBSERVICES | The party identified by this GUID has not been registered for the requested service |
| WEBSERVICES | Requested File does not exist either because it has not been published, it has been deleted, or the filename is incorrect |
| WEBSERVICES | At least one Name Type must be selected (Y). Blank defaults to Y |
| WEBSERVICES | At least one State must be selected (Y). Blank defaults to Y |
| WEBSERVICES | A Filename must be entered |
| WEBSERVICES | No name search criteria entered |
| WEBSERVICES | Year must be between 1999 and 2025 |
| WEBSERVICES | Month must be between 1 and 12 |
| WEBSERVICES | The party identified by this GUID has not been registered to access the superannuation download file |
| WEBSERVICES | The registration for the party identified by this GUID has been cancelled. Please contact ABNLookup.Support@industry.gov.au for assistance |
| WEBSERVICES | Name search type cannot be determined |
| WEBSERVICES | The service requested is not known |
| WEBSERVICES | An ABN is invalid in Name Search |
| WEBSERVICES | An ASIC number is invalid in Name Search |
| WEBSERVICES | An ACN is invalid in ABN Search |
| WEBSERVICES | An ABN is invalid in ACN Search |
| WEBSERVICES | The searchWidth field is not valid. Use either typical or narrow |
| WEBSERVICES | A 'Yes/No' field is invalid. Use either Y or N |