---
title: "Upload de Documentos da Pessoa"
method: POST
path: "/escrow/api/v1/documents/upload"
tags: ["Pessoas"]
---

# Upload de Documentos da Pessoa

`POST /escrow/api/v1/documents/upload`

## Request

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

Esse endpoint deve ser utilizado para gerar um link que irá possibilitar o envio de documentos relacionados ao cadastro do tilular de uma conta que será criada posteriormente.

Nós utilizamos o mecanismo de _"Pre-signed Uploads"_ da AWS:

1. Informar qual o nome do arquivo e sua extensão;
    
2. O serviço irá retornar uma "upload_url" e um "key";
    
3. No upload_url deve ser feito o upload do base64 do arquivo;
    
4. O parâmetro "key" deve ser utilizado posteriormente no campo "" no cadastro da pessoa titular da conta;
    

### Parâmetros do Body

- `file_name` (string, obrigatório): O nome completo do arquivo que será feito o upload com a extensão correta. Por exemplo "arquivo_identidade.pdf".
    

### Response

Se processado com sucesso será retornado um status_code "200" e um JSON no seguinte formato:

``` json
{
  "key": "<string>",
  "upload_url": "<string>",
  "download_url": "<string>"
}

 ```

- `key` (string/UUID): ID para identificação do arquivo que foi enviado;
    
- `upload_url` (string): URL para fazer o envio do arquivo;
    
- `download_url` (string): URL para fazer o download do arquivo;

## Headers

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

## Request body

- object

## Response `200`

OK

- object

---

[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)