Retrieve a Business Profile

Retrieve a business profile for a business

To retrieve a detailed business profile for one of the businesses returned via the search endpoint, you can request a profile. The profile calls return:

  • A JSON repose that contains the profile information
  • An URL to the location where you can download a PDF format for the same

You need to know the country/region you wish to search within, as well as the name of the business. You will also need the company code returned in the search call made previously.

Use the company code obtained in the previous step to retrieve the profile for the business. The profile contains details such as the business address, legal status, and lists of directors, shareholders and officeholders.

Retrieve a business profile using the /business/international/profile 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. Replace COMPANY_CODE_FROM_PREVIOUS_STEP with the company code.
  3. 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/profile \
     --header 'X-Frankie-CustomerID: YOUR_CUSTOMER_ID' \
     --header 'api_key: YOUR_API_KEY'
     --header 'content-type: application/json' \
     --data '{
       "company_code": "COMPANY_CODE_FROM_PREVIOUS_STEP",
       "country": "IE"
     }'

Response

The company profile response contains information about the Business itself and the Director and Shares details.

{
    "CompanyProfile": {
        "Addresses": {
            "Addresses": [
                {
                    "AddressInOneLine": "10 MOLESWORTH STREET, IRELAND, DUBLIN 2DUBLIN, 662881",
                    "AddressLine1": "10 MOLESWORTH STREET",
                    "AddressLine2": "IRELAND",
                    "AddressLine3": "DUBLIN 2DUBLIN",
                    "Postcode": "662881",
                    "TelephoneNumber": "016600311"
                }
            ]
        },
        "Code": "024173",
        "Date": "2022-04-22T04:41:03.8155772Z",
        "LegalForm": "PLC - PUBLIC LIMITED COMPANY",
        "Name": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
        "directorAndShareDetails": {
            "directors": {
                "Director": [
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "28/07/1958",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "28/10/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "JAMES PETTIGREW"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "11/07/1954",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "14/09/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "Jan  Sijbrand"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "11/07/1954",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "14/09/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "Jan Sijbrand"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "18/04/1974",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "14/09/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "Tanya Horgan"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "19/06/1961",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "01/07/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "Anik Chaumartin"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "27/06/1973",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "28/05/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "DONAL GALVIN"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "13/10/1966",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "15/03/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "Andrew Maguire"
                    },
                    {
                        "address1": "10 Molesworth Street",
                        "address4": "Dublin 2,DUBLIN,Ireland",
                        "birthdate": "23/04/1960",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "22/01/2021",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "FERGAL O'DWYER"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "19/04/1969",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "01/05/2020",
                                    "companyName": "AIB GROUP PUBLIC LIMITED COMPANY",
                                    "companyNumber": "594283",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                },
                                {
                                    "appointedDate": "01/05/2020",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                }
                            ]
                        },
                        "name": "CONOR GOULDSON"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "20/10/1968",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "04/09/2019",
                                    "companyName": "AIB GROUP PUBLIC LIMITED COMPANY",
                                    "companyNumber": "594283",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "04/09/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "BASIL GEOGHEGAN"
                    },
                    {
                        "address1": " 10 MOLESWORTH STREET",
                        "address4": "DUBLIN 2,DUBLIN",
                        "birthdate": "18/06/1962",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "04/09/2019",
                                    "companyName": "AIB GROUP PUBLIC LIMITED COMPANY",
                                    "companyNumber": "594283",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "04/09/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "ELAINE MACLEAN"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "07/09/1962",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "25/04/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "RANJIT SINGH"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "29/12/1964",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "25/04/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "ANN O'BRIEN"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "30/05/1958",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "22/03/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "SANDY KINNEY"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "05/07/1979",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "13/12/2018",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                }
                            ]
                        },
                        "name": "AEILISH MCGOVERN"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "15/11/1985",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "27/09/2018",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                },
                                {
                                    "appointedDate": "07/01/2019",
                                    "companyName": "ARK SECRETARIAL LIMITED",
                                    "companyNumber": "102555",
                                    "companyStatus": "Non trading",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "27/09/2018",
                                    "companyName": "AIB GROUP PUBLIC LIMITED COMPANY",
                                    "companyNumber": "594283",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                }
                            ]
                        },
                        "name": "EIMEAR DOOLEY"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "23/06/1981",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "27/09/2018",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Company Secretary"
                                }
                            ]
                        },
                        "name": "DIANE LUMSDEN"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "14/07/1958",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "27/10/2016",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "BRENDAN MCDONAGH"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "14/10/1967",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "17/12/2015",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "HELEN NORMOYLE"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "03/02/1967",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "27/10/2016",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                }
                            ]
                        },
                        "name": "CAROLAN LENNON"
                    },
                    {
                        "address1": "10 MOLESWORTH STREET",
                        "address2": "DUBLIN 2",
                        "birthdate": "06/07/1970",
                        "directorships": {
                            "Directorship": [
                                {
                                    "appointedDate": "21/01/2009",
                                    "companyName": "NCH SYMPHONY LIMITED",
                                    "companyNumber": "451296",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Company Secretary"
                                },
                                {
                                    "appointedDate": "16/01/2008",
                                    "companyName": "NCH SYMPHONY LIMITED",
                                    "companyNumber": "451296",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "08/03/2019",
                                    "companyName": "ALLIED IRISH BANKS, PUBLIC LIMITED COMPANY",
                                    "companyNumber": "024173",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "12/11/2010",
                                    "companyName": "PATHGLADE LIMITED",
                                    "companyNumber": "490262",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "12/11/2010",
                                    "companyName": "PATHGLADE LIMITED",
                                    "companyNumber": "490262",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Company Secretary"
                                },
                                {
                                    "appointedDate": "08/03/2019",
                                    "companyName": "AIB GROUP PUBLIC LIMITED COMPANY",
                                    "companyNumber": "594283",
                                    "companyStatus": "Active - Accounts Filed",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "12/11/2010",
                                    "companyName": "LÉANNTA PPP INVESTMENTS LIMITED",
                                    "companyNumber": "491404",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "12/11/2010",
                                    "companyName": "LÉANNTA PPP INVESTMENTS LIMITED",
                                    "companyNumber": "491404",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Company Secretary"
                                },
                                {
                                    "appointedDate": "05/11/2008",
                                    "companyName": "MPFI INVESTMENTS 1 LIMITED",
                                    "companyNumber": "460268",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Director"
                                },
                                {
                                    "appointedDate": "05/11/2008",
                                    "companyName": "MPFI INVESTMENTS 1 LIMITED",
                                    "companyNumber": "460268",
                                    "companyStatus": "Company is dissolved",
                                    "function": "Company Secretary"
                                }
                            ]
                        },
                        "name": "COLIN HUNT"
                    }
                ]
            },
            "shareHolderSummary": {
                "shareCapital": "1696488273.70"
            },
            "shareHolders": {
                "ShareholderDetails": [
                    {
                        "allInfo": "2714,381,238.00 ORDINARY  EUR .63",
                        "currency": "EUR",
                        "name": "AIB GROUP PLC",
                        "nominalValue": "0.6250",
                        "percentage": "100",
                        "shareType": "ORDINARY",
                        "shareholderType": "C"
                    }
                ]
            }
        }
    },
    "checkId": "cbdbcdd4-49e5-5fb2-38f2-7ce6ff40e8ac",
    "entityId": "0854bef5-06db-df98-b5e9-09b886fc140a",
    "ibRetrievalLocation": "https://data.kyckr.com/integration/2073633879",
    "requestId": "01G17S5H25ZZ2STKYQNDR2X6GY"
}

Extract the Entity ID

👍

What is the entityID used for?

The entityID is the unique identifier for all subsequent API calls to be made. It is also the unique identifier in the Frankie world.

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

const entityId = response['entityId']

Did this page help you?