---
title: "Gerar URL assinada para upload de documentos do devedor"
method: POST
path: "/laas/v2/debtors/url-document"
---

# Gerar URL assinada para upload de documentos do devedor

`POST /laas/v2/debtors/url-document`

## Request

- Base URL: `https://pagamentos.grafeno.be/api/v2`
- URL: `https://pagamentos.grafeno.be/api/v2/laas/v2/debtors/url-document`
- Auth: HTTP basic and API key in header `Authorization`
- TypeScript: <https://skmtc.dev/grafeno/apis/api-v2-grafeno/docs/laas/v2/debtors/url-document/post.ts> (a function with typed inputs; its response is checked against the schema)

Registra a URL para savar os documentos do tomador de crédito.

## Request body

- object
  - `debtor_identification` string, required: CPF ou CNPJ do tomador de crédito.
  - `file_type` 'debtor_identification_file' | 'debtor_proof_of_income_file' | 'debtor_address_proof_file' | 'debtor_social_or_statute_contract' | 'debtor_monthly_turnover_on_last_12_months_file' | 'representative_address_proof_file' | 'representative_identification_file', required: Tipo de documento que será submetido ao cadastro do tomador de crédito.
  - `file_format` 'pdf' | 'jpeg' | 'jpg', required: Formatos de arquivos válidos para os documentos.
  - `representative_identification` string: CPF do representante legal da empresa tomadora do crédito. <b>Se informado, o parâmetro debtor_identification com o CNPJ do tomador de crédito também deverá ser informado.</b>

## Response `201`

201

- object
  - `upload_url` string
  - `file_key` string
  - `expires_in_seconds` integer

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/grafeno/apis/api-v2-grafeno.md) - [All operations](https://skmtc.dev/grafeno/apis/api-v2-grafeno/llms.txt) - [OpenAPI document](https://skmtc.dev/grafeno/apis/api-v2-grafeno/revisions/20f928f6933f?raw)