> For the complete documentation index, see [llms.txt](https://docs.caf.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyb/business-identity.md). # Business Identity Our unique Business Identity dataset is the gold standard in KYB intelligence. Dive into 2.8 billion original records spanning 250+ global jurisdictions, even in challenging areas like Latin America, China, and Russia. Crafted meticulously by investigative experts, Business Identity not only consolidates fragmented data but ensures it's analysis-ready, maintaining a direct link to public records. Allowing you to navigate the intricate web of global corporate ownership effortlessly, always anchored to primary sources. Providing crystal clear insights and undeniable authenticity. **Section**: `kybBusinessIdentity` **Required parameter:** `businessIdentityId` Note: All fields returned by this API are optional and their presence cannot be guaranteed. Depending on the request or specific conditions, certain fields may not appear in the response. {% tabs %} {% tab title="Schema" %} | Attribute | Type | Description | | ---------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------ | | id | string | Internal company identification. | | name | string | Registered company name. | | number | string | Official registration number. | | identifiers | array of objects | | | identifiers.label | string | Description of the identifier | | identifiers.type | string | Type of the identifier | | identifiers.value | string | Identifier | | status | object | | | status.code | string | High-level status. | | status.description | string | A more in-depth status value. | | businessPurpose | string | Text and/or a code that describes what a company is legally allowed to do or produce | | registrationDate | date | The date the company was registered. | | addresses | array of strings | A physical location description | | countries | array of strings | All the countries related to the company. | | type | string | A type of legal entity in a given jurisdiction. | | aliasNames | array of strings | An alternative, former, or otherwise non-primary name. | | sources | array of objects | | | sources.id | string | ID of the source | | sources.name | string | Name of the source | | sources.total | number | Count of data taken from this source | | records | object | | | records.count | number | Count of records | | records.data | array of objects | | | records.data.id | string | ID of the associated record. | | records.data.type | string | Type of the record. Can be "about" or "mentions" | | records.data.label | string | Human readable label for the record. | | records.data.sourceId | string | ID of the associated source. | | records.data.sourceUrl | string | Url to the source associated with the record. | | records.data.acquisitionDate | string | Date of record publication. | | records.data.publicationDate | string | The date we acquired the source document. | | records.data.referencesCount | number | Count of entities referenced in source document. | | riskData | array of objects | | | riskData.name | string | Risk data type | | riskData.countries | array of strings | Countries associated with the risk data | | riskData.value | number, boolean | Risk data value | | attributes | array of objects | | | attributes.name | string | Nome of the attribute | | attributes.total | number | Total count of items within the attribute | | attributes.data | array of objects | | | attributes.data.properties | object | Properties of the attribute | | attributes.data.records | array of strings | Records reference | | relationships | object | | | relationships.directors | array of objects | | | relationships.directors.name | string | The name of the company director. | | relationships.directors.birthDate | date | The birth date of the company director. | | relationships.directors.former | boolean | Indicates if the director is a former director | | relationships.directors.pep | boolean | Indicates if the director is a politically exposed person (PEP) | | relationships.directors.sanctioned | boolean | Indicates if the director is sanctioned | | relationships.directors.addresses | array of strings | Addresses associated with the director | | relationships.directors.identifiers | array of strings | Identifiers associated with the director | | relationships.directors.appointmentDate | date | The date when the director was appointed | | relationships.directors.riskData | object | | | relationships.directors.riskData.basel\_aml | object | | | relationships.directors.riskData.basel\_aml.value | number | The value or score indicating the AML risk level | | relationships.directors.riskData.cpi\_score | object | | | relationships.directors.riskData.cpi\_score.value | number | The actual numerical value of the CPI score | | relationships.officers | array of objects | | | relationships.officers.name | string | The name of the company officer. | | relationships.officers.birthDate | date | The birth date of the company officer. | | relationships.officers.former | boolean | Indicates if the officer is a former officer | | relationships.officers.pep | boolean | Indicates if the officer is a politically exposed person (PEP) | | relationships.officers.sanctioned | boolean | Indicates if the officer is sanctioned | | relationships.officers.addresses | array of strings | Addresses associated with the officer | | relationships.officers.identifiers | array of strings | Identifiers associated with the officer | | relationships.officers.appointmentDate | date | The date when the officer was appointed | | relationships.officers.riskData | object | | | relationships.officers.riskData.basel\_aml | object | | | relationships.officers.riskData.basel\_aml.value | number | The value or score indicating the AML risk level | | relationships.officers.riskData.cpi\_score | object | | | relationships.officers.riskData.cpi\_score.value | number | The actual numerical value of the CPI score | | relationships.shareHolders | array of objects | | | relationships.shareHolders.name | string | The name of the company shareholder. | | relationships.shareHolders.birthDate | date | The birth date of the company shareholder. | | relationships.shareHolders.former | boolean | Indicates if the shareholder is a former shareholder | | relationships.shareHolders.pep | boolean | Indicates if the shareholder is a politically exposed person (PEP) | | relationships.shareHolders.sanctioned | boolean | Indicates if the shareholder is sanctioned | | relationships.shareHolders.addresses | array of strings | Addresses associated with the shareholder | | relationships.shareHolders.identifiers | array of strings | Identifiers associated with the shareholder | | relationships.shareHolders.appointmentDate | date | The date when the shareholder was appointed | | relationships.shareHolders.riskData | object | | | relationships.shareHolders.riskData.basel\_aml | object | | | relationships.shareHolders.riskData.basel\_aml.value | number | The value or score indicating the AML risk level | | relationships.shareHolders.riskData.cpi\_score | object | | | relationships.shareHolders.riskData.cpi\_score.value | number | The actual numerical value of the CPI score | | contact | object | | | contact.phoneNumbers | array of strings | List of contact phone number | | contact.emails | array of strings | List of contact email | | contact.websites | array of strings | List of contact website | | {% endtab %} | | | {% tab title="Example" %} ```json { "id": "uniqueId", "name": "Company X", "businessPurpose": "Business Purpose", "number": "00445790", "status": { "description": "Active", "code": "registered" }, "addresses": ["Address 1", "Address 2"], "sources": [ { "id": "7b3f91a4c28e6d7f2a4e682b15638d2a", "name": "Source 1", "total": 7 }, { "id": "7b3f91a4c28e6d7f2a4e682b15638d2a", "name": "Source 2", "total": 22 } ], "records": { "count": 1, "data": [ { "id": "7b3f91a4c28e6d7f2a4e682b15638d2a/603039824/1688515200000", "type": "about", "label": "Company Record from UK", "sourceId": "7b3f91a4c28e6d7f2a4e682b15638d2a", "sourceUrl": "https://country.gov/", "acquisitionDate": "2023-07-05", "publicationDate": "2023-07-05", "referencesCount": 6 }, ] }, "identifiers": [ { "type": "type1", "value": "123", "label": "Identifier 1" }, { "type": "type2", "value": "456", "label": "Identifier 2" } ], "countries": ["GB", "US"], "type": "Public Limited Company", "riskData": [ { "name": "regulatory_action", "value": true }, { "name": "basel_aml", "value": 3.99, "countries": ["GBR"] } ], "contact": { "phoneNumbers": [ "123456789", "1234567898", "(123) 123-1234", "1234342343434" ], "emails": [ "email@example.com", "email@example.com" ], "websites": ["example.com"] }, "relationships": { "shareHolders": [ { "addresses": ["Address"], "sanctioned": false, "identifiers": ["1234"], "name": "Person One", "pep": false, "birthDate": "1970-01-01", "former": false, "riskData": { "basel_aml": { "value": 0 }, "cpi_score": { "value": 0 } } } ], "directors": [ { "addresses": ["Address"], "sanctioned": false, "identifiers": ["123"], "name": "Person Two", "pep": false, "birthDate": "1970-01-01", "appointmentDate": "1970-01-01", "former": false, "riskData": { "basel_aml": { "value": 0 }, "cpi_score": { "value": 0 } } } ], "officers": [ { "addresses": ["Address"], "sanctioned": false, "identifiers": ["123"], "name": "Person Three", "pep": false, "birthDate": "1970-01-01", "former": true, "riskData": { "basel_aml": { "value": 0 }, "cpi_score": { "value": 0 } } } ] }, "aliasNames": ["Alias Name 1", "Alias Name 2"], "attributes": [ { "name": "status", "data": [ { "properties": { "from_date": "1970-01-01", "value": "registered" } }, { "properties": { "value": "active", "text": "Active" } }, { "properties": { "date": "1970-01-01", "value": "incorporated" } } ], "total": 3 } ] } ``` {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.caf.io/caf-api/core-api/transaction-details/background-check/kyb/business-identity.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.