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

# Obtém os registros de identificação da pessoa natural

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

## Request

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

Método para obter os registros de identificação da pessoa natural mantidos na instituição transmissora.
        
PERMISSÃO NECESSÁRIA: `CUSTOMERS_PERSONAL_IDENTIFICATIONS_READ`

## Query parameters

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

## Response `200`

Dados sobre identificação pessoa física obtidos com sucesso

- object
  - `data` object[], required
    - `updateDateTime` string, date-time, required: Data e hora da atualização dos campos, formato UTC
    - `personalId` string, required: Identificador único e imutável do cliente pessoa natural
    - `brandName` string, required: Nome da Marca reportada pelo participante no Open Finance
    - `civilName` string, required: Nome civil completo da pessoa natural
    - `socialName` string: Nome social da pessoa natural, se houver
    - `birthDate` string, date, required: Data de nascimento
    - `maritalStatusCode` 'SOLTEIRO' | 'CASADO' | 'VIUVO' | 'SEPARADO_JUDICIALMENTE' | 'DIVORCIADO' | 'UNIAO_ESTAVEL' | 'OUTRO': Estado marital do cliente
    - `sex` 'FEMININO' | 'MASCULINO' | 'OUTRO': Sexo da pessoa
    - `companiesCnpj` string[], required: CNPJ da instituição responsável pelo Cadastro
    - `documents` object, required
      - `cpfNumber` string: Número completo do CPF
      - `passport` object: Documento de passaporte (para residentes no exterior)
        - `number` string: Número do Passaporte
        - `country` string: País de emissão do passaporte (código ISO-3166)
    - `hasBrazilianNationality` boolean, required: Informa se o Cliente tem nacionalidade brasileira
    - `contacts` object, required
      - `postalAddresses` object[], required: Lista de endereços da pessoa natural
        - `isMain` boolean: Indica se é o endereço principal
        - `address` string: Endereço residencial do cliente
        - `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)