Search For a Business

You can search for businesses across registries in different countries. You can either search by using the name or the registration number(specific to the country).

• You need to know the country/region you wish to search within, as well as the name of the business. The name does not need to be the full legal name of the business. When a partial name is used you can expect to receive all the matches for the name in the country/region Country Codes
• You can also search for businesses by their registration number, which will be specific to each registry. This is the unique identifier for a business in a specific region, for example - ACN in Australia, UTR in Ireland

Perform a business search with a partial name or number using the /business/international/search endpoint.

1. In the example below, replace YOUR_CUSTOMER_ID with your Customer ID and YOUR_API_Key with your API key provided by FrankieOne.
2. Copy the resulting code into your command line, and run the command.

Request

curl --request POST \
     --url https://api.demo.frankiefinancial.io/compliance/v1.2/business/international/search \
     --header 'X-Frankie-CustomerID: YOUR_CUSTOMER_ID' \
     --header 'api_key: YOUR_API_KEY'
     --header 'content-type: application/json' \
     --data '{
       "country": "IE",
       "organisation_name": "Frankie"
     }'

curl --request POST \
     --url https://api.demo.frankiefinancial.io/compliance/v1.2/business/international/search \
     --header 'X-Frankie-CustomerID: YOUR_CUSTOMER_ID' \
     --header 'api_key: YOUR_API_KEY'
     --header 'content-type: application/json' \
     --data '{
       "country": "IE",
       "organisation_number": "550594137"
     }'

Response

The response will contain a list of businesses that matched against the supplied name parameter or the details of the specific business for the specified organisation number.

{
	"Companies": {
		"CompanyDTO": [{
			"Addresses": {
				"Addresses": [{
					"AddressInOneLine": "TRARALGON, VIC, 3844"
				}]
			},
			"Aliases": {
				"AddressLine": null
			},
			"Code": "551422854_FRANKIE PTY LTD",
			"CompanyID": "551422854",
			"Date": "23/04/2009",
			"LegalForm": "APTY",
			"LegalStatus": "REGD",
			"Name": "FRANKIE PTY LTD",
			"RegistrationAuthorityCode": "ASIC"
		}]
	},
	"ibResponseCode": 100,
	"requestId": "01G12BW569W5Q21P8PJTJBAB4F"
}

{
	"Companies": {
		"CompanyDTO": [{
			"Addresses": {
				"Addresses": [{
					"AddressInOneLine": "TRARALGON, VIC, 3844"
				}]
			},
			"Aliases": {
				"AddressLine": null
			},
			"Code": "551422854_FRANKIE PTY LTD",
			"CompanyID": "551422854",
			"Date": "23/04/2009",
			"LegalForm": "APTY",
			"LegalStatus": "REGD",
			"Name": "FRANKIE PTY LTD",
			"RegistrationAuthorityCode": "ASIC"
		}]
	},
	"ibResponseCode": 100,
	"requestId": "01G12BW569W5Q21P8PJTJBAB4F"
}

❗

Jurisdictions not supported with Search By number

• Bangladesh, BD
• Brazil, BR
• Illinois (US), US-IL
• Indonesia, ID
• Morocco, MA
• New York (US), US-NY
• Oman, OM
• South Carolina (US), US-SC
• Trinidad and Tobago, TT

Extract the company code

👍

What is it used for?

The company code is used in subsequent steps to retrieve profile information on the company.

Searching for a business may return multiple matches. Each match will have a unique company code. Identify the correct match and extract the company code. you will need it in the next step.

For example, extract the company code for the first matched result:

const companyCode = response['Companies']['CompanyDTO'][0]['Code']

Extract the registration authority code

👍

What is it used for?

The registration authority code is used in subsequent steps to retrieve profile information in jurisdictions where there are more than one registry.

Searching for a business may return multiple matches in a country with the same company code when there are multiple registries. In cases where a registration authority code is present in the results, extract the value for use when retrieving the business profile.

For example, extract the registration authority code for the first matched result:

const RegistrationAuthorityCode = response['Companies']['CompanyDTO'][0]['RegistrationAuthorityCode']