This is in beta. If you find something wrong, let us know

ABN Lookup

This is a prototype

Getting started

Registration

Search by ABN

Search by ASIC number

Search by Name

Search with Filters

Web services response

Exceptions

Reference data

Data dictionary

Sample code and resources

Change control

Search by Name

The Search by Name methods return a list of names that match the search criteria. Search tips has information to help you understand the ABN Lookup search.

There are five versions of the Search by Name method. The Simple Protocol versions have the same functionality as the corresponding SOAP versions but can be called using Http get/post protocols. The Search by Name methods are:

  1. ABRSearchByNameAdvanced2017 (SOAP only) and ABRSearchByNameAdvancedSimpleProtocol2017 - latest
  1. ABRSearchByNameAdvanced2012 (SOAP only) and ABRSearchByNameAdvancedSimpleProtocol2012
  1. ABRSearchByNameAdvanced2006 (SOAP only) and ABRSearchByNameAdvancedSimpleProtocol2006
  1. ABRSearchByNameAdvanced (SOAP only) and ABRSearchByNameAdvancedSimpleProtocol
  1. ABRSearchByName (SOAP only) and ABRSearchByNameSimpleProtocol

The table below describes the Search by Name request.

Description of Search by Name request

ElementComments
NameString to search for
PostcodeMatch against postcode of the main business location
Name Type Filters legalName businessName tradingNameRestrict search to selected name types – i.e. Legal name and/or business name. Valid values are "Y" , "N" or blank. By default all Name Types are searched. If none of the options are "Y" (i.e. they are all "N" or blank), then all Name Types are included in the search
State Filters NSW, SA, ACT, VIC, WA, NT, QLD, TASRestrict search to selected states in the main business location. Valid values are "Y", "N" or blank. The default is to include all states. If none of the options are "Y" (i.e. they are either "N" or blank), all states are included
authenticationGUIDGUID provided when you registered for access to the web services
searchWidthDefines the search strategy. Only available in the advanced name search. Valid values are "Typical" and "Narrow"
minimumScoreThe lowest acceptable score. Only available in the advanced name search. Accepted values are positive integers between 50 and 100
maxSearchResultsThe maximum number of records to return from the search. Default is 200. Only available in the advanced 2006 name search. Must be a positive integer
activeABNsOnlyRestrict search to only active ABNs. Only available in the advanced 2017 name search. Valid values are "Y", "N" or blank

The table below describes the validation rules for the Search by Name request.

Validation rules Search by Name request

ElementError ConditionException Text
NameAn ABN is enteredAn ABN is invalid in a name search
NameAn ASIC number is enteredAn ASIC Number is invalid in a name search
Name Type FiltersInvalid value – i.e. not "Y", "N" or blankThe name type element has an invalid value according to its data type
State FiltersInvalid value – i.e. not "Y", "N" or blankThe state element has an invalid value according to its data type
postcodeExceeds 12 charactersThe 'postcode' element has an invalid value according to its data type
authenticationGUIDGUID not foundThe authenticationGUID is invalid
searchWidthInvalid valueThe 'searchWidth' element has an invalid value according to its data type
minimumScoreInvalid valueThe 'minimumScore' element has an invalid value according to its data type
maxSearchResultsInvalid valueThe 'maxSearchResults ' element has an invalid value according to its data type


Last edited: 19 May 2020, 08:48:20