---
title: "Pedido de consentimento de dados"
method: POST
path: "/baas/v1/open/dat/consents"
tags: ["Consentimento"]
---

# Pedido de consentimento de dados

`POST /baas/v1/open/dat/consents`

Cria novo pedido de consentimento

## Request body

- ConsentRequest
  - `data` object, required
    - `loggedUser` object, required
      - `document` object, required
        - `identification` string, required — Número do documento de identificação do usuário detentor dos dados. Deve ser um CPF (11 dígitos) ou CNPJ (14 dígitos), sem pontos, traços ou barras
        - `rel` 'CPF' | 'CNPJ', required — Tipo do documento de identificação do usuário detentor dos dados.
    - `permissions` string[], required
    - `expirationDateTime` string, date-time — Data e hora de expiração da permissão. Reflete a data limite de validade do consentimento. Uma string com data e hora conforme especificação RFC-3339, sempre com a utilização de timezone UTC (UTC time format). [Restrição] De preenchimento obrigatório nos casos em que houver validade determinada. Em casos de consentimento com prazo indeterminado o campo não deve ser enviado. Quando preenchido, o valor do campo não pode ultrapassar 12 meses.Data e hora de expiração do consentimento em formato ISO 8601
  - `brandId` string, required

## Response `201`

Consentimento criado com sucesso

- ConsentResponse
  - `authorizationUrl` string, uri — URL de autorização para redirecionamento do usuário detentor dos dados. A URL deve ser aberta em um navegador web para que o usuário possa autenticar-se e conceder o consentimento. [Observação] A URL de autorização é dinâmica e única para cada pedido de consentimento. Deve ser utilizada apenas uma vez e tem validade limitada (geralmente 5 minutos). Após esse período, um novo pedido de consentimento deve ser criado para obter uma nova URL.
  - `id` string — ID único do pedido de consentimento criado

## Other responses

- `400` — Dados inválidos
- `401` — Token inválido, expirado ou não enviado
- `422` — Dados de entrada inválidos

---

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