> 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/caf-api-pt-br/api-core/transaction-details/background-check/kyb/business-identity.md).

# Identidade empresarial

Nosso conjunto de dados exclusivo Business Identity é o padrão ouro em inteligência KYB. Mergulhe em 2,8 bilhões de registros originais abrangendo mais de 250 jurisdições globais, até mesmo em áreas desafiadoras como América Latina, China e Rússia. Elaborado meticulosamente por especialistas em investigações, o Business Identity não apenas consolida dados fragmentados, mas também garante que estejam prontos para análise, mantendo um vínculo direto com registros públicos. Permitindo que você navegue sem esforço pela intrincada rede de propriedade corporativa global, sempre ancorado em fontes primárias. Oferecendo insights cristalinos e autenticidade inquestionável.

**Seção**: `kybBusinessIdentity`

**Parâmetro obrigatório:** `businessIdentityId`

Observação: todos os campos retornados por esta API são opcionais e sua presença não pode ser garantida. Dependendo da solicitação ou de condições específicas, certos campos podem não aparecer na resposta.

{% tabs %}
{% tab title="Esquema" %}

| Atributo                                                 | Tipo                 | Descrição                                                                                          |
| -------------------------------------------------------- | -------------------- | -------------------------------------------------------------------------------------------------- |
| id                                                       | cadeia de caracteres | Identificação interna da empresa.                                                                  |
| nome                                                     | cadeia de caracteres | Nome registrado da empresa.                                                                        |
| número                                                   | cadeia de caracteres | Número de registro oficial.                                                                        |
| identificadores                                          | array de objetos     |                                                                                                    |
| identificadores.rótulo                                   | cadeia de caracteres | Descrição do identificador                                                                         |
| identificadores.tipo                                     | cadeia de caracteres | Tipo do identificador                                                                              |
| identificadores.valor                                    | cadeia de caracteres | Identificador                                                                                      |
| status                                                   | objeto               |                                                                                                    |
| status.código                                            | cadeia de caracteres | Status em alto nível.                                                                              |
| status.description                                       | cadeia de caracteres | Um valor de status mais detalhado.                                                                 |
| finalidadeComercial                                      | cadeia de caracteres | Texto e/ou um código que descreve o que uma empresa está legalmente autorizada a fazer ou produzir |
| registrationDate                                         | data                 | A data em que a empresa foi registrada.                                                            |
| endereços                                                | array de strings     | Uma descrição de localização física                                                                |
| países                                                   | array de strings     | Todos os países relacionados à empresa.                                                            |
| tipo                                                     | cadeia de caracteres | Um tipo de pessoa jurídica em uma determinada jurisdição.                                          |
| nomesAlternativos                                        | array de strings     | Um nome alternativo, anterior ou de outro modo não principal.                                      |
| fontes                                                   | array de objetos     |                                                                                                    |
| fontes.id                                                | cadeia de caracteres | ID da fonte                                                                                        |
| fontes.nome                                              | cadeia de caracteres | Nome da fonte                                                                                      |
| fontes.total                                             | número               | Quantidade de dados obtidos desta fonte                                                            |
| registros                                                | objeto               |                                                                                                    |
| registros.contagem                                       | número               | Quantidade de registros                                                                            |
| registros.dados                                          | array de objetos     |                                                                                                    |
| registros.dados.id                                       | cadeia de caracteres | ID do registro associado.                                                                          |
| registros.dados.tipo                                     | cadeia de caracteres | Tipo do registro. Pode ser "sobre" ou "menções"                                                    |
| registros.dados.rótulo                                   | cadeia de caracteres | Rótulo legível para humanos do registro.                                                           |
| registros.dados.idDaFonte                                | cadeia de caracteres | ID da fonte associada.                                                                             |
| registros.dados.urlDaFonte                               | cadeia de caracteres | URL para a fonte associada ao registro.                                                            |
| registros.dados.dataDeAquisição                          | cadeia de caracteres | Data de publicação do registro.                                                                    |
| registros.dados.dataDePublicação                         | cadeia de caracteres | A data em que adquirimos o documento-fonte.                                                        |
| registros.dados.contagemDeReferências                    | número               | Quantidade de entidades referenciadas no documento-fonte.                                          |
| dadosDeRisco                                             | array de objetos     |                                                                                                    |
| dadosDeRisco.nome                                        | cadeia de caracteres | Tipo de dado de risco                                                                              |
| dadosDeRisco.países                                      | array de strings     | Países associados aos dados de risco                                                               |
| dadosDeRisco.valor                                       | número, booleano     | Valor do dado de risco                                                                             |
| atributos                                                | array de objetos     |                                                                                                    |
| atributos.nome                                           | cadeia de caracteres | Nome do atributo                                                                                   |
| atributos.total                                          | número               | Contagem total de itens dentro do atributo                                                         |
| atributos.dados                                          | array de objetos     |                                                                                                    |
| atributos.dados.propriedades                             | objeto               | Propriedades do atributo                                                                           |
| atributos.dados.registros                                | array de strings     | Referência de registros                                                                            |
| relacionamentos                                          | objeto               |                                                                                                    |
| relacionamentos.diretores                                | array de objetos     |                                                                                                    |
| relacionamentos.diretores.nome                           | cadeia de caracteres | O nome do diretor da empresa.                                                                      |
| relacionamentos.diretores.dataDeNascimento               | data                 | A data de nascimento do diretor da empresa.                                                        |
| relacionamentos.diretores.anterior                       | booleano             | Indica se o diretor é um ex-diretor                                                                |
| relacionamentos.diretores.pep                            | booleano             | Indica se o diretor é uma pessoa exposta politicamente (PEP)                                       |
| relacionamentos.diretores.sancionado                     | booleano             | Indica se o diretor está sancionado                                                                |
| relacionamentos.diretores.endereços                      | array de strings     | Endereços associados ao diretor                                                                    |
| relacionamentos.diretores.identificadores                | array de strings     | Identificadores associados ao diretor                                                              |
| relacionamentos.diretores.dataDeNomeação                 | data                 | A data em que o diretor foi nomeado                                                                |
| relacionamentos.diretores.dadosDeRisco                   | objeto               |                                                                                                    |
| relacionamentos.diretores.dadosDeRisco.basel\_aml        | objeto               |                                                                                                    |
| relacionamentos.diretores.dadosDeRisco.basel\_aml.valor  | número               | O valor ou pontuação que indica o nível de risco de AML                                            |
| relacionamentos.diretores.dadosDeRisco.cpi\_score        | objeto               |                                                                                                    |
| relacionamentos.diretores.dadosDeRisco.cpi\_score.valor  | número               | O valor numérico real do score CPI                                                                 |
| relacionamentos.executivos                               | array de objetos     |                                                                                                    |
| relacionamentos.executivos.nome                          | cadeia de caracteres | O nome do executivo da empresa.                                                                    |
| relacionamentos.executivos.dataDeNascimento              | data                 | A data de nascimento do executivo da empresa.                                                      |
| relacionamentos.executivos.anterior                      | booleano             | Indica se o executivo é um ex-executivo                                                            |
| relacionamentos.executivos.pep                           | booleano             | Indica se o executivo é uma pessoa exposta politicamente (PEP)                                     |
| relacionamentos.executivos.sancionado                    | booleano             | Indica se o executivo está sancionado                                                              |
| relacionamentos.executivos.endereços                     | array de strings     | Endereços associados ao executivo                                                                  |
| relacionamentos.executivos.identificadores               | array de strings     | Identificadores associados ao executivo                                                            |
| relacionamentos.executivos.dataDeNomeação                | data                 | A data em que o executivo foi nomeado                                                              |
| relacionamentos.executivos.dadosDeRisco                  | objeto               |                                                                                                    |
| relacionamentos.executivos.dadosDeRisco.basel\_aml       | objeto               |                                                                                                    |
| relacionamentos.executivos.dadosDeRisco.basel\_aml.valor | número               | O valor ou pontuação que indica o nível de risco de AML                                            |
| relacionamentos.executivos.dadosDeRisco.cpi\_score       | objeto               |                                                                                                    |
| relacionamentos.executivos.dadosDeRisco.cpi\_score.valor | número               | O valor numérico real do score CPI                                                                 |
| relacionamentos.acionistas                               | array de objetos     |                                                                                                    |
| relacionamentos.acionistas.nome                          | cadeia de caracteres | O nome do acionista da empresa.                                                                    |
| relacionamentos.acionistas.dataDeNascimento              | data                 | A data de nascimento do acionista da empresa.                                                      |
| relacionamentos.acionistas.anterior                      | booleano             | Indica se o acionista é um ex-acionista                                                            |
| relacionamentos.acionistas.pep                           | booleano             | Indica se o acionista é uma pessoa exposta politicamente (PEP)                                     |
| relacionamentos.acionistas.sancionado                    | booleano             | Indica se o acionista está sancionado                                                              |
| relacionamentos.acionistas.endereços                     | array de strings     | Endereços associados ao acionista                                                                  |
| relacionamentos.acionistas.identificadores               | array de strings     | Identificadores associados ao acionista                                                            |
| relacionamentos.acionistas.dataDeNomeação                | data                 | A data em que o acionista foi nomeado                                                              |
| relacionamentos.acionistas.dadosDeRisco                  | objeto               |                                                                                                    |
| relacionamentos.acionistas.dadosDeRisco.basel\_aml       | objeto               |                                                                                                    |
| relacionamentos.acionistas.dadosDeRisco.basel\_aml.valor | número               | O valor ou pontuação que indica o nível de risco de AML                                            |
| relacionamentos.acionistas.dadosDeRisco.cpi\_score       | objeto               |                                                                                                    |
| relacionamentos.acionistas.dadosDeRisco.cpi\_score.valor | número               | O valor numérico real do score CPI                                                                 |
| contato                                                  | objeto               |                                                                                                    |
| contato.númerosDeTelefone                                | array de strings     | Lista de números de telefone de contato                                                            |
| contact.emails                                           | array de strings     | Lista de e-mails de contato                                                                        |
| contact.websites                                         | array de strings     | Lista de sites de contato                                                                          |
| {% endtab %}                                             |                      |                                                                                                    |

{% tab title="Exemplo" %}

```json
{
  "id": "uniqueId",
  "name": "Empresa X",
  "businessPurpose": "Finalidade comercial",
  "number": "00445790",
  "status": {
    "description": "Ativo",
    "code": "registrado"
  },
  "addresses": ["Endereço 1", "Endereço 2"],
  "sources": [
    {
      "id": "7b3f91a4c28e6d7f2a4e682b15638d2a",
      "name": "Fonte 1",
      "total": 7
    },
    {
      "id": "7b3f91a4c28e6d7f2a4e682b15638d2a",
      "name": "Fonte 2",
      "total": 22
    }
  ],
  "records": {
    "count": 1,
    "data": [
      {
        "id": "7b3f91a4c28e6d7f2a4e682b15638d2a/603039824/1688515200000",
        "type": "sobre",
        "label": "Registro da empresa do Reino Unido",
        "sourceId": "7b3f91a4c28e6d7f2a4e682b15638d2a",
        "sourceUrl": "https://country.gov/",
        "acquisitionDate": "2023-07-05",
        "publicationDate": "2023-07-05",
        "referencesCount": 6
      },
    ]
  },
  "identifiers": [
    {
      "type": "type1",
      "value": "123",
      "label": "Identificador 1"
    },
    {
      "type": "type2",
      "value": "456",
      "label": "Identificador 2"
    }
  ],
  "countries": ["GB", "US"],
  "type": "Sociedade anônima de capital aberto",
  "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": ["Endereço"],
        "sanctioned": false,
        "identifiers": ["1234"],
        "name": "Pessoa Um",
        "pep": false,
        "birthDate": "1970-01-01",
        "former": false,
        "riskData": {
          "basel_aml": {
            "value": 0
          },
          "cpi_score": {
            "value": 0
          }
        }
      }
    ],
    "directors": [
      {
        "addresses": ["Endereço"],
        "sanctioned": false,
        "identifiers": ["123"],
        "name": "Pessoa Dois",
        "pep": false,
        "birthDate": "1970-01-01",
        "appointmentDate": "1970-01-01",
        "former": false,
        "riskData": {
          "basel_aml": {
            "value": 0
          },
          "cpi_score": {
            "value": 0
          }
        }
      }
    ],
    "officers": [
      {
        "addresses": ["Endereço"],
        "sanctioned": false,
        "identifiers": ["123"],
        "name": "Pessoa Três",
        "pep": false,
        "birthDate": "1970-01-01",
        "former": true,
        "riskData": {
          "basel_aml": {
            "value": 0
          },
          "cpi_score": {
            "value": 0
          }
        }
      }
    ]
  },
  "aliasNames": ["Nome alternativo 1", "Nome alternativo 2"],
  "attributes": [
    {
      "name": "status",
      "data": [
        {
          "properties": {
            "from_date": "1970-01-01",
            "value": "registrado"
          }
        },
        {
          "properties": {
            "value": "ativo",
            "text": "Ativo"
          }
        },
        {
          "properties": {
            "date": "1970-01-01",
            "value": "constituído"
          }
        }
      ],
      "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/caf-api-pt-br/api-core/transaction-details/background-check/kyb/business-identity.md?ask=<question>&goal=<user_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.
