> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frankieone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 response 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.

<Callout icon="thumbtack" color="#1A6CFF" iconType="regular">
  ##### Registration authority code

  If a registration authority code was returned in the search results, it must be included when calling the profile endpoint for accurate results. In some jurisdictions, the profile call will not work without this code.
</Callout>

Retrieve a business profile using the [/business/international/profile](/docs/v1/api/kyc-api-endpoints/reference/business/international-business-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. Replace REGISTRATION\_AUTHORITY\_CODE\_FROM\_PREVIOUS\_STEP with the registration authority code.
4. Copy the resulting code into your command line, and run the command.

#### Request

```json Request theme={null}

    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",  
           "registration_authority_code":"REGISTRATION_AUTHORITY_CODE_FROM_PREVIOUS_STEP"  
         }'

```

#### Response

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

```json Response expandable theme={null}
{
  "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"
          }
        ]
      },
      "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

<Callout icon="check" color="#3DD892" iconType="regular">
  ##### What's the entityID used for?

  The entityID is the unique identifier for all subsequent API calls to be made. It’s also the unique identifier in the Frankie world.
</Callout>

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

```javascript Retrieving an entityId theme={null}
     const entityId = response["entityId"];  
```