---
title: "Consulta de status de consentimento"
url: "https://devcenter.stone.com.br/conciliacao-consulta-de-status-de-consentimento"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_Consulta+de+status+de+consentimento,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9jb25jaWxpYWNhby1jb25zdWx0YS1kZS1zdGF0dXMtZGUtY29uc2VudGltZW50byI,s_W331dl1wwcRKRBtz.png"
---

# Consulta de status de consentimento

## [Endpoint](#endpoint)

```text
GET https://conciliation.stone.com.br/v2/merchant/consents/status
```

### [Query params](#query-params)

| Nome     | Obrigatório | Tipo   | Descrição |
| :------- | :---------- | :----- | :-------- |
| clientId | sim         | string |           |
| document | sim         | string |           |

Este é um endpoint público (sem autenticação) que permite consultar todos os consentimentos de um merchant. É útil para:

-   Verificar o status de consentimentos antes de fazer novos pedidos, para evitar sobrecarregar o lojista com muitos e-mails desnecessários.
-   Diagnosticar problemas de recebimento de e-mail ou webhook.
-   Verificar qual o identificador dos consentimentos para facilitar a busca em sistemas internos dos integradores.

---

### [Query params](#query-params-1)

| Parâmetro | Tipo   | Obrigatório | Descrição                                                                      |
| :-------- | :----- | :---------- | :----------------------------------------------------------------------------- |
| clientId  | string | ✅           | Identificador do parceiro que está fazendo a requisição.                       |
| document  | string | ✅           | CNPJ (14 dígitos) ou CPF (11 dígitos) do merchant, sem pontos, hífen ou barra. |

**Exemplo:** GET `/v2/merchant/consents/status?clientId=app-123&document=12345678000190`

---

O resultado será informado através do código de status HTTP da resposta.

| HTTP Status Code | Descrição                                                                        |
| :--------------- | :------------------------------------------------------------------------------- |
| 200              | Sucesso. Retorna a lista de consentimentos.                                      |
| 400              | Erro nos dados informados para a API.                                            |
| 404              | Erro no formato da URL ou no método enviado                                      |
| 429              | Limite de requisições excedido, máximo de 7 requisições por hora para um mesmo par de clientId e documento. |
| 500              | Ocorreu um erro interno na API, por favor nos informe                            |
| 502              | Um dos sistemas da Stone falhou, por favor nos informe                           |

## [Resposta 200 — lista de consentimentos](#resposta-200-lista-de-consentimentos)

Retorna um array com no máximo 100 consentimentos, ordenados do mais recente para o mais antigo por `createdAt`.

```json
[
  {
      "consentId": "6a187fc840aa10c116048933",
      "status": "pending",
      "createdAt": "2026-05-28T17:47:52.671Z",
      "updatedAt": "2026-05-28T17:47:52.671Z"
  },
  {
      "consentId": "6a187fa540aa10c116048932",
      "status": "accepted",
      "createdAt": "2026-05-28T17:47:17.439Z",
      "updatedAt": "2026-05-28T17:48:04.48Z"
  }
]
```

Quando não há consentimentos para o merchant:

```json
[]
```

### [Status de consentimento](#status-de-consentimento)

| Status   | Descrição                                             |
| :------- | :---------------------------------------------------- |
| pending  | Aguardando ação do merchant (aprovação ou rejeição)   |
| accepted | Merchant aprovou o consentimento                      |
| active   | Consentimento ativo e em uso                          |
| denied   | Merchant rejeitou o consentimento                     |
| revoked  | Consentimento revogado (aprovação anterior cancelada) |

**Limite de resultados:** O endpoint retorna no máximo 100 consentimentos por chamada, ordenados pelos mais recentes. Não há suporte a paginação. Na prática, a maioria dos merchants tem menos de 100 consentimentos, quantidades acima disso indica um uso indevido da API.

Ao atingir o limite de 7 requisições por hora para uma mesma combinação de `clientId` e `document`, a API retornará `429 Too Many Requests`. Aguarde o reset da janela de 1 hora antes de realizar novas requisições.

---

**Jornada: [Obter o consentimento e autenticar](https://devcenter.stone.com.br/conciliacao-pedido-de-consentimento)**  
Etapa 4 de 6

[**Etapa anterior**Decriptando senha](https://devcenter.stone.com.br/conciliacao-decriptando-senha)[**Próxima etapa**Consulta de identificadores do lojista](https://devcenter.stone.com.br/conciliacao-consulta-de-identificadores-do-lojista)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.