---
title: "Criar uma pessoa do tipo \"física\""
method: POST
path: "/escrow/api/persons"
tags: ["Pessoas"]
---

# Criar uma pessoa do tipo "física"

`POST /escrow/api/persons`

## Request

- Base URL: `https://sandbox.platform.credit.celcoin.com.br`
- URL: `https://sandbox.platform.credit.celcoin.com.br/escrow/api/persons`
- Auth: none declared

Esse endpoint deve ser utilizado para cadastrar uma Pessoa do tipo física, usando um nº de CPF como identificador.

### Parâmetros do Body

- `name` (string, obrigatório): O nome completo da pessoa.
    
- `person_type` (string, obrigatório): O tipo da pessoa, informar o valor como "NATURAL" para o cadastro de uma pessoa física. Possíveis valores: NATURAL, LEGAL.
    
- `taxpayer_id` (string, obrigatório): O número do documento CPF para identificação da Pessoa.
    
- `documents` (object, obrigatório): Objeto contendo as 'keys' das URLs _'pre-signed'_ dos documentos de identificação (documentIdentification) e comprovante de endereço (proofOfAddress).
    
- `id_document` (object, obrigatório): Objeto para detalhar o documento de identificação que esta sendo enviado.
    
    - `issueDate` (string, obrigatório): Data de emissão do documento.
        
    - `issuer` (string, obrigatório): Orgão responsável pela emissão do documento.
        
    - `number` (string, obrigatório): Número do documento.
        
    - `type` (string, obrigatório): Tipo do documento. Valores aceitos: CNH, PASSPORT, RG, RNE.
        
- `birth_date` (string, obrigatório): Data de nascimento da Pessoa a ser cadastrada no formato "AAAA-MM-DD".
    
- `mother_name` (string, obrigatóri): Nome da mãe.
    
- `pep` (boolean, obrigatório): Campo para indica se a pessoa é politicamente exposta.
    
- `email_address` (string, obrigatório): Endereço de e-mail para contato com a pessoa cadastrada.
    
- `phone` (object, obrigatório): Objeto contendo os dados do telefone de contato.
    
    - `country_code` (string): Código do país.
        
    - `area_code` (string): Código de área.
        
    - `number` (string): Número do telefone.
        
- `address` (object, obrigatório): Objeto contendo detalhes do endereço de cadastro.
    
    - `street_number` (string): Número do endereço informado.
        
    - `street_name` (string): Nome da rua.
        
    - `postal_code` (string): Código de CEP para o endereço.
        
    - `district` (string): Campo para informar o bairro.
        
    - `city` (string): Nome da cidade.
        
    - `state_code` (string): Código da UF para o estado do endereço.
        
    - `country_code` (string): Código do país.
        
    - `extra_info` (string): Complemento do endereço.
        
- `fund_manager_id` (string/uuid v4): ID do gestor do Fundo, se aplicável.
    
- `fund_securitizer_id` (string/uuid v4): ID da securitizadora do Fundo, se aplicável.
    
- `fund_administrator_id` (string/uuid v4): ID do Admnistrador do Fundo, se aplicável.
    

### Resposta

A resposta da requisição será um JSON representando o retorno obtido para os campos enviados.

Em caso de sucesso será retornado um _status_code_ "200-OK". Em caso de falha será retornado um código 40x com a mensagem indicativa do erro.

- `id` (string/uuid v4): ID gerado para o cadastro realizado da Pessoa física.
    

##### Exemplo de JSON:

``` json
{
    "id": ""
}

 ```

## Headers

- `Content-Type` string
- `Accept` string

## Request body

- object

## Response `200`

OK

- object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/celcoin/apis/celcoin-escrow.md) - [All operations](https://skmtc.dev/celcoin/apis/celcoin-escrow/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/celcoin-escrow/revisions/5d55a35a6d51?raw)