ABN Lookup
Search with Filters
The Search with Filters methods return a list of matching ABNs. These methods are intended to be used with Search by ABN methods. The Search with Filters methods are:
- SearchByPostcode
- SearchByABNStatus
- SearchByUpdateEvent
- SearchByRegistrationEvent
- SearchByCharity
The table below describes the Search with filters request.
Description of Search with Filters request
| Element | Comments |
|---|---|
| postcode | Postcode of the main business location to filter on |
| state | State of the main business location to filter on |
| activeABNsOnly | Include only ABNs that are currently active. Valid values are "Y" or "N" |
| currentGSTRegistrationOnly | Include only ABNs that are currently registered for GST. Valid values are "Y" or "N" |
| entityTypeCode | Include only ABNs that belong to the selected entity type code. Valid values are a 3 letter entity type code or blank. The default is to include all entity types |
| concessionTypeCode | Include only ABNs that are registered for the selected concession type code. Valid values are a 4 letter concession type code or blank. The default is to include all concession types |
| updateDate | Include only ABNs updated on this date. Must be a valid date in the form yyyy-mm-dd |
| month | Include only ABNs updated in this month (and year). Must be an integer between 1 and 12 |
| year | Include only ABNs updated in this year (and month). Must be an 4 digit integer representing a year between 1999 and the current year |
| authenticationGuid | The GUID provided when you registered for access to the web services |
The table below describes the validation rules for the Search with Filters request.
Validation rules for Search with Filters request
| Element | Error Condition | Exception Text |
|---|---|---|
| year | Invalid value – must be a integer between 1999 and the current year | Year must be between 1999 and current year |
| month | Invalid value – must be an integer between 1 and 12 | Month must be between 1 and 12 |
| authenticationGuid | GUID not found | The Authentication GUID is invalid |