Search For a Business

Search for a Business in a specific country

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"
            },
            {
                "Addresses": {
                    "Addresses": [
                        {
                            "AddressInOneLine": "DONCASTER EAST, VIC, 3109"
                        }
                    ]
                },
                "Aliases": {
                    "AddressLine": null
                },
                "Code": "550594137_FRANKIE GAL PTY LTD",
                "CompanyID": "550594137",
                "Date": "12/09/2006",
                "LegalForm": "APTY",
                "LegalStatus": "REGD",
                "Name": "FRANKIE GAL PTY LTD"
            },
            {
                "Addresses": {
                    "Addresses": [
                        {}
                    ]
                },
                "Aliases": {
                    "AddressLine": null
                },
                "Code": "050308962_FRANKIE GOES TO HOLLYWOOD INCORPORATED",
                "CompanyID": "050308962",
                "Date": "04/12/1996",
                "LegalForm": "ASSN",
                "LegalStatus": "REGD",
                "Name": "FRANKIE GOES TO HOLLYWOOD INCORPORATED"
            },
            {
                "Addresses": {
                    "Addresses": [
                        {}
                    ]
                },
                "Aliases": {
                    "AddressLine": null
                },
                "Code": "050308962_FRANKIE GOES TO HOLLYWOOD INCORPORATED",
                "CompanyID": "050308962",
                "Date": "04/12/1996",
                "LegalForm": "ASSN",
                "LegalStatus": "REGD",
                "Name": "FRANKIE GOES TO HOLLYWOOD INCORPORATED"
            },
            {
                "Addresses": {
                    "Addresses": [
                        {}
                    ]
                },
                "Aliases": {
                    "AddressLine": null
                },
                "Code": "050308962_FRANKIE GOES TO HOLLYWOOD SOCIETY INCORPORATED",
                "CompanyID": "050308962",
                "Date": "04/12/1996",
                "LegalForm": "ASSN",
                "LegalStatus": "REGD",
                "Name": "FRANKIE GOES TO HOLLYWOOD SOCIETY INCORPORATED"
            }
        ]
    },
    "ibResponseCode": 100,
    "requestId": "01G12BW569W5Q21P8PJTJBAB4F"
}
{
    "Companies": {
        "CompanyDTO": [
            {
                "Addresses": {
                    "Addresses": [
                        {
                            "AddressInOneLine": "DONCASTER EAST, VIC, 3109"
                        }
                    ]
                },
                "Aliases": {
                    "AddressLine": null
                },
                "Code": "550594137_FRANKIE GAL PTY LTD",
                "CompanyID": "550594137",
                "LegalForm": "APTY",
                "LegalStatus": "REGD",
                "Name": "FRANKIE GAL PTY LTD"
            }
        ]
    },
    "ibResponseCode": 100,
    "requestId": "01G12ES9BJGG94X8C8AKBQSFFD"
}

Extract the company code

👍

What is it used for?

The company code is used in all the subsequent steps to retrieve information from the KYCKR end.

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']

Did this page help you?