---
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`

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.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)