---
title: "Obtém os registros de identificação da pessoa jurídica"
method: GET
path: "/baas/v1/open/dat/customers/business/identifications"
tags: ["Customers | Dados"]
---

# Obtém os registros de identificação da pessoa jurídica

`GET /baas/v1/open/dat/customers/business/identifications`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v1/open/dat/customers/business/identifications`
- Auth: HTTP bearer

Método para obter os registros de identificação da pessoa jurídica mantidos na instituição transmissora.

PERMISSÃO NECESSÁRIA: `CUSTOMERS_BUSINESS_IDENTIFICATIONS_READ`

## Query parameters

- `page` integer
- `page-size` integer

## Response `200`

Dados de identificação da pessoa jurídica obtidos com sucesso

- object
  - `data` object[], required
    - `updateDateTime` string, date-time, required: Data e hora da atualização dos campos
    - `businessId` string, required: Identificador único da pessoa jurídica
    - `brandName` string, required: Nome da Marca reportada pelo participante
    - `companyName` string, required: Razão social da empresa
    - `tradeName` string, required: Nome fantasia da empresa
    - `incorporationDate` string, date, required: Data de constituição da empresa
    - `cnpjNumber` string, required: Número completo do CNPJ da pessoa jurídica
    - `companySize` 'MICROEMPRESA' | 'PEQUENA_EMPRESA' | 'MEDIA_EMPRESA' | 'GRANDE_EMPRESA': Porte da empresa
    - `economicActivities` object[]
      - `code` integer, required: Código CNAE
      - `isMain` boolean, required: Indica se é a atividade principal
    - `companiesCnpj` string[], required: CNPJ da instituição responsável
    - `otherDocuments` object[], required
      - `type` 'CNPJ' | 'OUTROS', required: Tipo do documento
      - `number` string, required: Número do documento
      - `country` string, required: País de emissão (ISO-3166)
      - `expirationDate` string, date, required: Data de vencimento do documento
    - `parties` object[], required
      - `personType` 'PESSOA_NATURAL' | 'PESSOA_JURIDICA', required: Tipo de pessoa
      - `type` 'REPRESENTANTE_LEGAL' | 'PROCURADOR' | 'CONTROLADOR' | 'BENEFICIARIO_FINAL' | 'ACIONISTA' | 'QUOTISTA' | 'SOCIO' | 'ADMINISTRADOR', required: Tipo de vínculo da pessoa com a empresa
      - `civilName` string, required: Nome civil da pessoa
      - `socialName` string, required: Nome social da pessoa
      - `companyName` string, required: Razão social (PJ)
      - `tradeName` string, required: Nome fantasia (PJ)
      - `startDate` string, date, required: Data de início do vínculo
      - `shareholding` string: Percentual de participação societária
      - `documentType` 'CPF' | 'CNPJ' | 'PASSAPORTE': Tipo de documento de identidade
      - `documentNumber` string: Número do documento
      - `documentAdditionalInfo` string: Campo de informações adicionais
      - `documentCountry` string: País de emissão (ISO-3166)
      - `documentExpirationDate` string, date: Data de vencimento do documento
      - `documentIssueDate` string, date: Data de emissão do documento
    - `contacts` object, required
      - `postalAddresses` object[], required: Lista de endereços da pessoa jurídica
        - `isMain` boolean: Indica se é o endereço principal
        - `address` string: Endereço da empresa
        - `townName` string: Nome da cidade
        - `postCode` string: Código de Endereçamento Postal (CEP)
        - `country` string: Nome do país
        - `countryCode` string: Código do país (ISO-3166)
      - `phones` object[], required: Lista de telefones de contato
        - `isMain` boolean: Indica se é o telefone principal
        - `type` 'FIXO' | 'MOVEL' | 'OUTRO': Tipo de telefone
        - `areaCode` string: Código de área (DDD)
        - `number` string: Número do telefone
      - `emails` object[], required: Lista de e-mails de contato
        - `isMain` boolean: Indica se é o e-mail principal
        - `email` string, email: Endereço de e-mail
  - `links` Links, required: Referências para outros recursos da API requisitada
    - `self` string, uri, required: URI completo que gerou a resposta atual
    - `first` string, uri: URI da primeira página que originou essa lista de resultados
    - `prev` string, uri: URI da página anterior dessa lista de resultados
    - `next` string, uri: URI da próxima página dessa lista de resultados
    - `last` string, uri: URI da última página dessa lista de resultados
  - `meta` Meta, required: Meta informações referente à API requisitada
    - `totalRecords` integer, required: Número total de registros no resultado
    - `totalPages` integer, required: Número total de páginas no resultado
    - `requestDateTime` string, date-time, required: Data e hora da consulta, conforme especificação RFC-3339, formato UTC

## Other responses

- `400`: Requisição malformada
- `401`: Token inválido ou não autorizado
- `403`: Token tem escopo incorreto ou política de segurança violada
- `404`: Recurso não encontrado
- `429`: Muitas solicitações foram feitas dentro de um determinado período

---

[API](https://skmtc.dev/celcoin/apis/api-para-transa-es.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-transa-es/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-transa-es/revisions/85dd6188a37b?raw)