ABN Lookup
Exceptions
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:
Exception Codes and Descriptions
| Code | Description examples |
|---|---|
| GENERAL | Unknown name search error |
| GENERAL | Error starting search |
| GENERAL | Error finishing search |
| GENERAL | Error opening session |
| GENERAL | Error closing session |
| GENERAL | Error opening IDS System |
| GENERAL | Error closing system |
| GENERAL | Error retrieving matching records from the Search |
| GENERAL | Error retrieving IDT field count |
| GENERAL | Error retrieving IDT field information |
| SEARCH | Unknown search error |
| SEARCH | Could not determine search type |
| SEARCH | Search text is invalid for name search |
| SEARCH | Unknown |
| SEARCH | Problem accessing ABN Lookup database. |
| SYSTEM | System problems have prevented this request from completing |
| WEBSERVICES | Unknown web services error |
| 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 Include History flag must be 'Y' or 'N' |
| 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 GUID must be supplied to access service |
| WEBSERVICES | A Filename must be entered |
| WEBSERVICES | No name search criteria entered |
| WEBSERVICES | The flag must be 'Y' or 'N' |
| WEBSERVICES | Year must be between 1999 and 2018 |
| 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 party identified by this GUID has not been registered to access the superannuation web services |
| WEBSERVICES | The registration for the party identified by this GUID has been cancelled |
| WEBSERVICES | State must be NSW, VIC, QLD, SA, TAS, ACT, NT, WA. For all states, leave blank |
| WEBSERVICES | Error logging to the statistical database |
| WEBSERVICES | Name search type cannot be determined |
| WEBSERVICES | External request is not valid according to scheme |
| WEBSERVICES | The service requested is not known |
| WEBSERVICES | The search method 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 |