Business Lookup
Business lookup methods take partial or complete business information to search against the business Source of Truth, returning validated and enriched business information.
Last updated
Business lookup methods take partial or complete business information to search against the business Source of Truth, returning validated and enriched business information.
Last updated
To complete business lookup requires one Find API that returns detailed information of the business entity.
Find - Returns a list of valid business based on partial or complete business information.
Supported Countries: Australia, New Zealand
A comprehensive guide that signifies the essential requirements that needs to be met to access Business Lookup.
Lookup businesses using a partial or complete business information in a single line business field.
The name to be searched can be a business number, company or any entity names.
HTTP POST will only process the first record in the request.
Default Port is 18080. Port number is configurable. For details on how to use a different port, refer Getting Started
required input field*
country*
string
AU
ISO 2 country AU or NZ
name*
string
"gbg aust"
partial/complete business name or registered business number or company number
nameTypes
string
"TRD,BN,OTN"
Filters for specific or multiple Entity types depending on country.
Australia
MN-->Main Entity name;
LGL-->Legal Entity Name (individuals/sole traders). Use with MN;
TRD-->Trading name in Other Entity;
BN-->Business name in Other Entity; DGR-->Deductible Gift Recipient;
OTN-->Other name in Other Entity.
New Zealand
MN-->Main Entity name;
TRD-->Trading name in Other Entity;
OTN-->Other name in Other Entity.
bnStatus
string
"ACT" default blank
Filters based on business number status. Options ACT = Active, CAN = Cancelled
taxStatus
string
"ACT" default blank
Filters based on business tax status. Options ACT = Active, CAN = Cancelled, NON = None
State
string
"NSW, QLD" default blank
Filters for specific or multiple states the business is located. Blank is all. state is only applicable for au.
hits
integer
5 default 20
Number of results to be returned from the Find response.
caseType
string
"TITLE" default UP
The case type for the returned information UP,LOW,TITLE
Response will be a combination of Main Entity name, Trading Name and Business names etc.
{
"name": "Mastersoft",
"country": "au",
"bnStatus":"ACT",
"state": [
"NSW","VIC"
],
"caseType": "TITLE"
}when response is not a main entity name then display_name in json response is set to
display_name: XXX(mn) trading as YYY(TRD)
name: XXX(mn)
when response is a main name, display_name in json response is the same as name
display_name: XXX(mn)
name: XXX(mn)
{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "Mastersoft Pty. Ltd.",
"name": "Mastersoft Pty. Ltd.",
"bn": "15007342029",
"cn": "007342029",
"state": "VIC",
"postcode": "3144",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20000501",
"tax_status": "CAN",
"tax_status_from_date": "20211002",
"entity_type_ind": "PRV",
"entity_type_text": "Australian Private Company",
"other_entities": [
{
"entity_name": "Mastersoft Pty Ltd",
"entity_type": "TRD"
}
],
"attributes": {
"month_in_business": "283"
},
"last_updated_date": "20211028"
},
{
"display_name": "Mastersoft Pty. Ltd. Trading As Mastersoft Pty Ltd",
"name": "Mastersoft Pty. Ltd.",
"bn": "15007342029",
"cn": "007342029",
"state": "VIC",
"postcode": "3144",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20000501",
"tax_status": "CAN",
"tax_status_from_date": "20211002",
"entity_type_ind": "PRV",
"entity_type_text": "Australian Private Company",
"other_entities": [
{
"entity_name": "Mastersoft Pty Ltd",
"entity_type": "TRD"
}
],
"attributes": {
"month_in_business": "283"
},
"last_updated_date": "20211028"
},
{
"display_name": "Mastersoft Superannuation Fund",
"name": "Mastersoft Superannuation Fund",
"bn": "57290362590",
"state": "VIC",
"postcode": "3006",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20000406",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "SMF",
"entity_type_text": "ATO Regulated Self-Managed Superannuation Fund",
"other_entities": [
{
"entity_name": "Mastersoft Superannuation Fund",
"entity_type": "TRD"
}
],
"attributes": {
"month_in_business": "283"
},
"last_updated_date": "20190731"
},
{
"display_name": "Mastersoft Superannuation Fund Trading As Mastersoft Superannuation Fund",
"name": "Mastersoft Superannuation Fund",
"bn": "57290362590",
"state": "VIC",
"postcode": "3006",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20000406",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "SMF",
"entity_type_text": "ATO Regulated Self-Managed Superannuation Fund",
"other_entities": [
{
"entity_name": "Mastersoft Superannuation Fund",
"entity_type": "TRD"
}
],
"attributes": {
"month_in_business": "283"
},
"last_updated_date": "20190731"
},
{
"display_name": "Mastersoft Group Pty Ltd",
"name": "Mastersoft Group Pty Ltd",
"bn": "91151055800",
"cn": "151055800",
"state": "NSW",
"postcode": "2000",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20110523",
"tax_status": "ACT",
"tax_status_from_date": "20110523",
"entity_type_ind": "PRV",
"entity_type_text": "Australian Private Company",
"attributes": {
"month_as_tax_business": "150",
"month_in_business": "150"
},
"last_updated_date": "20200214"
}
]
}http://localhost:18080/business/v1/find?country=au&name=claudio%20esp&nameTypes=LGL&caseType=UP{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "CLAUDIO ESPINOZA",
"name": "CLAUDIO ESPINOZA",
"bn": "52755328790",
"state": "NSW",
"postcode": "2136",
"country": "au",
"bn_status": "CAN",
"bn_status_from_date": "20080811",
"tax_status": "CAN",
"tax_status_from_date": "20080811",
"entity_type_ind": "IND",
"entity_type_text": "Individual/Sole Trader",
"last_updated_date": "20100805"
},
{
"display_name": "CLAUDIO ESPINOSA",
"name": "CLAUDIO ESPINOSA",
"bn": "79698017130",
"state": "WA",
"postcode": "6000",
"country": "au",
"bn_status": "CAN",
"bn_status_from_date": "20151103",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "IND",
"entity_type_text": "Individual/Sole Trader",
"last_updated_date": "20151103"
},
{
"display_name": "CLAUDIO ESPOSITO",
"name": "CLAUDIO ESPOSITO",
"bn": "79171302295",
"state": "VIC",
"postcode": "3012",
"country": "au",
"bn_status": "CAN",
"bn_status_from_date": "20210429",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "IND",
"entity_type_text": "Individual/Sole Trader",
"last_updated_date": "20210429"
},
{
"display_name": "MR CLAUDIO ENRIQUE ESPINOSA",
"name": "MR CLAUDIO ENRIQUE ESPINOSA",
"bn": "70604342414",
"state": "QLD",
"postcode": "4078",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20070701",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "IND",
"entity_type_text": "Individual/Sole Trader",
"attributes": {
"month_in_business": "197"
},
"last_updated_date": "20070701"
},
{
"display_name": "CLAUDIO ALEJANDRO HERRERA ESPINDOLA",
"name": "CLAUDIO ALEJANDRO HERRERA ESPINDOLA",
"bn": "24350648123",
"state": "NSW",
"postcode": "2000",
"country": "au",
"bn_status": "CAN",
"bn_status_from_date": "20231003",
"tax_status": "NON",
"tax_status_from_date": "19000101",
"entity_type_ind": "IND",
"entity_type_text": "Individual/Sole Trader",
"last_updated_date": "20231004"
}
]
}{
"name": "Mastersoft",
"country": "au",
"bnStatus":"ACT",
"nameTypes":["MN"],
"taxStatus":"ACT",
"state": [
"NSW","VIC"
],
"caseType": "UP"
}{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "MASTERSOFT GROUP PTY LTD",
"name": "MASTERSOFT GROUP PTY LTD",
"bn": "91151055800",
"cn": "151055800",
"state": "NSW",
"postcode": "2000",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20110523",
"tax_status": "ACT",
"tax_status_from_date": "20110523",
"entity_type_ind": "PRV",
"entity_type_text": "Australian Private Company",
"attributes": {
"month_as_tax_business": "150",
"month_in_business": "150"
},
"last_updated_date": "20200214"
}
]
}http://localhost:18080/business/v1/find?country=au&name=15007342029{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "MASTERSOFT PTY. LTD.",
"name": "MASTERSOFT PTY. LTD.",
"bn": "15007342029",
"cn": "007342029",
"state": "VIC",
"postcode": "3144",
"country": "au",
"bn_status": "ACT",
"bn_status_from_date": "20000501",
"tax_status": "CAN",
"tax_status_from_date": "20211002",
"entity_type_ind": "PRV",
"entity_type_text": "Australian Private Company",
"other_entities": [
{
"entity_name": "MASTERSOFT PTY LTD",
"entity_type": "TRD"
}
],
"attributes": {
"month_in_business": "283"
},
"last_updated_date": "20211028"
}
]
}{
"name": "shelkam engin",
"country": "nz",
"bnStatus":"ACT",
"caseType": "UP"
}{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "SHELKAM ENGINEERING LIMITED TRADING AS SHELKAM ENGINEERING LTD",
"name": "SHELKAM ENGINEERING LIMITED",
"bn": "9429032232776",
"cn": "2248146",
"postcode": "0992",
"country": "nz",
"bn_status": "ACT",
"bn_status_from_date": "2009-05-25T00:00:00",
"entity_type_ind": "LTD",
"entity_type_text": "NZ Limited Company",
"other_entities": [
{
"entity_name": "SHELKAM ENGINEERING LTD",
"entity_type": "TRD"
}
],
"addresses": [
{
"type": "PhysicalAddress",
"fullAddress": "227 A WAIRAU ROAD, WAIRAU VALLEY, AUCKLAND",
"postcode": "0672",
"country": "NZ",
"start_date": "2009-05-25T00:00:00",
"end_date": "2016-05-04T00:00:00"
},
{
"type": "PhysicalAddress",
"fullAddress": "137 YOUNG ACCESS, RD 2, SILVERDALE",
"postcode": "0992",
"country": "NZ",
"start_date": "2016-05-04T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "137 YOUNG ACCESS, RD 2, SILVERDALE",
"postcode": "0992",
"country": "NZ",
"start_date": "2016-05-04T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "227 A WAIRAU ROAD, WAIRAU VALLEY, AUCKLAND",
"postcode": "0672",
"country": "NZ",
"start_date": "2009-05-25T00:00:00",
"end_date": "2016-05-04T00:00:00"
}
],
"directors": [
{
"asicDirectorshipYn": "false",
"roleAddress": [],
"roleAsicAddress": [],
"rolePerson": [
{
"firstName": "Mohanan",
"lastName": "NAIR",
"middleNames": "Gopalakrishnan"
}
],
"roleStatus": "ACTIVE",
"roleType": "Director",
"startDate": "2009-05-25T00:00:00"
},
{
"asicDirectorshipYn": "false",
"roleAddress": [],
"roleAsicAddress": [],
"rolePerson": [
{
"firstName": "Sheela",
"lastName": "NAIR",
"middleNames": "Mohanan"
}
],
"roleStatus": "ACTIVE",
"roleType": "Director",
"startDate": "2009-05-25T00:00:00"
}
],
"info": {
"annualReturnFilingMonth": "6",
"annualReturnLastFiled": "2023-06-02T05:53:59",
"extensiveShareholding": "false",
"hasConstitutionFiled": "false",
"overseasCompany": "false",
"shareholding": [
{
"numberOfShares": "100",
"shareAllocation": [
{
"allocation": "50",
"shareholder": [
{
"appointmentDate": "2009-05-25T00:00:00",
"individualShareholder": [
{
"firstName": "Mohanan",
"fullName": "Mohanan Gopalakrishnan NAIR",
"lastName": "NAIR",
"middleNames": "Gopalakrishnan"
}
],
"otherShareholder": [],
"shareholderAddress": [],
"type": "individual"
}
]
},
{
"allocation": "50",
"shareholder": [
{
"appointmentDate": "2009-05-25T00:00:00",
"individualShareholder": [
{
"firstName": "Sheela",
"fullName": "Sheela Mohanan NAIR",
"lastName": "NAIR",
"middleNames": "Mohanan"
}
],
"otherShareholder": [],
"shareholderAddress": [],
"type": "individual"
}
]
}
]
}
]
},
"attributes": {
"bn_start_date": "2009-05-25T00:00:00",
"detailed_bn_status": "50 (Registered)",
"month_in_business": "174",
"registration_date": "2009-05-25T00:00:00"
},
"last_updated_date": "2022-07-05T20:52:46"
},
{
"display_name": "SHELKAM ENGINEERING LIMITED",
"name": "SHELKAM ENGINEERING LIMITED",
"bn": "9429032232776",
"cn": "2248146",
"postcode": "0992",
"country": "nz",
"bn_status": "ACT",
"bn_status_from_date": "2009-05-25T00:00:00",
"entity_type_ind": "LTD",
"entity_type_text": "NZ Limited Company",
"other_entities": [
{
"entity_name": "SHELKAM ENGINEERING LTD",
"entity_type": "TRD"
}
],
"addresses": [
{
"type": "PhysicalAddress",
"fullAddress": "227 A WAIRAU ROAD, WAIRAU VALLEY, AUCKLAND",
"postcode": "0672",
"country": "NZ",
"start_date": "2009-05-25T00:00:00",
"end_date": "2016-05-04T00:00:00"
},
{
"type": "PhysicalAddress",
"fullAddress": "137 YOUNG ACCESS, RD 2, SILVERDALE",
"postcode": "0992",
"country": "NZ",
"start_date": "2016-05-04T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "137 YOUNG ACCESS, RD 2, SILVERDALE",
"postcode": "0992",
"country": "NZ",
"start_date": "2016-05-04T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "227 A WAIRAU ROAD, WAIRAU VALLEY, AUCKLAND",
"postcode": "0672",
"country": "NZ",
"start_date": "2009-05-25T00:00:00",
"end_date": "2016-05-04T00:00:00"
}
],
"directors": [
{
"asicDirectorshipYn": "false",
"roleAddress": [],
"roleAsicAddress": [],
"rolePerson": [
{
"firstName": "Mohanan",
"lastName": "NAIR",
"middleNames": "Gopalakrishnan"
}
],
"roleStatus": "ACTIVE",
"roleType": "Director",
"startDate": "2009-05-25T00:00:00"
},
{
"asicDirectorshipYn": "false",
"roleAddress": [],
"roleAsicAddress": [],
"rolePerson": [
{
"firstName": "Sheela",
"lastName": "NAIR",
"middleNames": "Mohanan"
}
],
"roleStatus": "ACTIVE",
"roleType": "Director",
"startDate": "2009-05-25T00:00:00"
}
],
"info": {
"annualReturnFilingMonth": "6",
"annualReturnLastFiled": "2023-06-02T05:53:59",
"extensiveShareholding": "false",
"hasConstitutionFiled": "false",
"overseasCompany": "false",
"shareholding": [
{
"numberOfShares": "100",
"shareAllocation": [
{
"allocation": "50",
"shareholder": [
{
"appointmentDate": "2009-05-25T00:00:00",
"individualShareholder": [
{
"firstName": "Mohanan",
"fullName": "Mohanan Gopalakrishnan NAIR",
"lastName": "NAIR",
"middleNames": "Gopalakrishnan"
}
],
"otherShareholder": [],
"shareholderAddress": [],
"type": "individual"
}
]
},
{
"allocation": "50",
"shareholder": [
{
"appointmentDate": "2009-05-25T00:00:00",
"individualShareholder": [
{
"firstName": "Sheela",
"fullName": "Sheela Mohanan NAIR",
"lastName": "NAIR",
"middleNames": "Mohanan"
}
],
"otherShareholder": [],
"shareholderAddress": [],
"type": "individual"
}
]
}
]
}
]
},
"attributes": {
"bn_start_date": "2009-05-25T00:00:00",
"detailed_bn_status": "50 (Registered)",
"month_in_business": "174",
"registration_date": "2009-05-25T00:00:00"
},
"last_updated_date": "2022-07-05T20:52:46"
}
]
}{
"name": "Mas eng",
"country": "nz",
"bnStatus":"CAN",
"caseType": "TITLE",
"nameTypes":["MN","TRD"]
}{
"status": "SUCCESS",
"messages": [],
"payload": [
{
"display_name": "Mas Engineers Limited Trading As Mas Engineers Ltd",
"name": "Mas Engineers Limited",
"bn": "9429036054343",
"cn": "1288118",
"postcode": "3110",
"country": "nz",
"bn_status": "CAN",
"bn_status_from_date": "2016-07-08T17:11:00",
"entity_type_ind": "LTD",
"entity_type_text": "NZ Limited Company",
"other_entities": [
{
"entity_name": "Mas Engineers Ltd",
"entity_type": "TRD"
}
],
"classifications": [
{
"type": "IndustryClassification",
"attributes": {
"classificationCode": "M692343",
"classificationDescription": "Engineering consulting service nec"
}
}
],
"addresses": [
{
"type": "PhysicalAddress",
"fullAddress": "37 Braeburn Place, Tauranga",
"country": "NZ",
"start_date": "2003-03-28T00:00:00",
"end_date": "2011-08-09T00:00:00"
},
{
"type": "PhysicalAddress",
"fullAddress": "37 Braeburn Place, Bethlehem, Tauranga",
"postcode": "3110",
"country": "NZ",
"start_date": "2011-08-09T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "37 Braeburn Place, Bethlehem, Tauranga",
"postcode": "3110",
"country": "NZ",
"start_date": "2011-08-09T00:00:00"
},
{
"type": "RegisteredAddress",
"fullAddress": "37 Braeburn Place, Tauranga",
"country": "NZ",
"start_date": "2003-03-28T00:00:00",
"end_date": "2011-08-09T00:00:00"
}
],
"directors": [
{
"asicDirectorshipYn": "false",
"roleAddress": [],
"roleAsicAddress": [],
"rolePerson": [
{
"firstName": "Kathryn",
"lastName": "ANGELL",
"middleNames":