> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cakto.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar Chargebacks e MEDs

> As contestações dos seus produtos e o estado da defesa de cada uma.

#### Escopo

```bash theme={null}
    read orders
```

## O que esta chamada traz

Os chargebacks e MEDs dos seus produtos no período (`period`, 90 dias por padrão), contados pela data
da contestação. A aba `awaiting`, que é o padrão, é a fila do que ainda pode ser defendido, com o
prazo mais próximo primeiro. É a mesma lista de **Minhas vendas › Chargeback e MED** no painel.

O `id` da disputa é o `orderId`, o id do pedido. Use-o em [Consultar](/api-reference/disputes/retrieve),
[Enviar defesa](/api-reference/disputes/defense) e [Complementar](/api-reference/disputes/complement).

> [!NOTE]
>
> O pré-chargeback não aparece: ele é um alerta, não uma contestação, e não comporta defesa. Veja o
> [guia de chargeback, pré-chargeback e MED](https://ajuda.cakto.com.br/pt-br/articles/73-chargeback-pre-chargeback-e-med).

## Abas (`status`)

| Valor | O que entra |
| - | - |
| `awaiting` | Aguardando defesa (`awaiting_defense`) ou com complemento pedido (`needs_info`) |
| `in_review` | Com o Compliance da Cakto (`submitted`, `in_review`) ou no banco (`sent`) |
| `won` | Revertidas a seu favor |
| `lost` | Mantidas pelo banco ou não encaminhadas (`declined`) |
| `expired` | O prazo de defesa terminou sem envio |
| `all` | Todas |

`counts` traz o total de cada aba no período, e `summary`, os números do painel: quantas estão a
defender, o valor delas, o próximo prazo e o que foi revertido em 90 dias.

## Para saber de uma contestação nova

Não é preciso consultar esta lista em intervalos. O webhook
[`dispute_defense_requested`](/conceitos/webhooks) avisa quando um chargeback ou MED abre prazo de
defesa, com o prazo no corpo do evento.


## OpenAPI

````yaml GET /public_api/disputes/
openapi: 3.0.3
info:
  title: Cakto API
  version: 1.0.0
  description: Documentação da API pública do Cakto.
servers:
  - url: https://api.cakto.com.br
    description: Cakto API
security: []
paths:
  /public_api/disputes/:
    get:
      tags:
        - disputes
      description: >-
        Chargebacks e MEDs dos seus produtos no período, com o estado da defesa
        de cada um. A aba `awaiting` (default) é a fila do que ainda pode ser
        defendido, pelo prazo mais próximo. O pré-chargeback não aparece: ele
        não comporta defesa.
      operationId: disputes_list
      parameters:
        - in: query
          name: limit
          schema:
            type: integer
          description: Itens por página. Default `10`, máximo `50`.
        - in: query
          name: page
          schema:
            type: integer
          description: Página a retornar. Default `1`.
        - in: query
          name: period
          schema:
            type: integer
            enum:
              - 30
              - 365
              - 90
          description: Dias para trás, pela data da contestação. Default `90`.
        - in: query
          name: search
          schema:
            type: string
          description: refId do pedido, nome do produto ou nome ou e-mail do comprador.
        - in: query
          name: status
          schema:
            type: string
            enum:
              - all
              - awaiting
              - expired
              - in_review
              - lost
              - won
          description: >-
            Aba da lista. `awaiting` (default): aguardando defesa ou com
            complemento pedido. `in_review`: com o Compliance ou no banco.
            `won`, `lost` (inclui a não encaminhada), `expired` e `all`.
        - in: query
          name: type
          schema:
            type: string
            enum:
              - all
              - chargeback
              - med
          description: Tipo da contestação. Default `all`.
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
              examples:
                AguardandoDefesa:
                  value:
                    count: 1
                    next: null
                    previous: null
                    results:
                      - refId: Q7W2k9P
                        orderId: 5f2a1c3e-8b7d-4e21-9f10-3c6d7a2b9e41
                        kind: chargeback
                        productName: Curso de Exemplo
                        customerName: Maria Souza
                        amount: '197.00'
                        formattedAmount: R$ 197,00
                        openedAt: '2026-10-19T10:12:40.118302-03:00'
                        deadline: '2026-10-25T23:59:59-03:00'
                        status: awaiting_defense
                        statusLabel: Aguardando defesa
                        canSubmit: true
                        submittedAt: null
                        decidedAt: null
                    counts:
                      awaiting: 1
                      in_review: 0
                      won: 0
                      lost: 0
                      expired: 0
                      all: 1
                    summary:
                      awaiting: 1
                      awaitingAmount: '197.00'
                      awaitingFormattedAmount: R$ 197,00
                      nextDeadline: '2026-10-25T23:59:59-03:00'
                      inReview: 0
                      won90d: 0
                      decided90d: 0
                      recovered90d: '0.00'
                      recoveredFormatted90d: R$ 0,00
                      disputeRate30d: null
                      disputeRateLimit: '1.00'
                  summary: Aguardando defesa
          description: >-
            Disputas da aba pedida. `counts` traz o total de cada aba, e
            `summary`, os números do painel (a defender, próximo prazo,
            revertidos em 90 dias).
        '401':
          description: Request não autenticado devido à ausência ou invalidez do token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthenticatedError'
              examples:
                Token ausente ou inválido:
                  $ref: '#/components/examples/UnauthenticatedErrorExample'
        '502':
          content:
            application/json:
              schema:
                type: object
                additionalProperties: {}
              examples:
                ServicoIndisponivel:
                  value:
                    detail: >-
                      Não foi possível falar com o serviço de pagamentos. Tente
                      de novo em instantes.
          description: >-
            O serviço de pagamentos não respondeu. Nada foi gravado: repita a
            chamada.
      security:
        - OAuth Token: []
components:
  schemas:
    UnauthenticatedError:
      type: object
      properties:
        detail:
          type: string
  examples:
    UnauthenticatedErrorExample:
      summary: Token ausente ou inválido
      description: Token ausente ou inválido
      value:
        detail: As credenciais de autenticação não foram fornecidas.
  securitySchemes:
    OAuth Token:
      type: http
      scheme: bearer
      in: header
      name: Authorization
      description: >-
        Token de autenticação do tipo `Bearer {access_token}`, onde
        `{access_token}` é o token obtido no fluxo de
        [autenticação](/authentication).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.