---
title: "Lista disputas de chargeback"
method: GET
path: "/v1/disputes"
tags: ["Disputas"]
---

# Lista disputas de chargeback

`GET /v1/disputes`

## Request

- Base URL: `https://api.stone.com.br`
- URL: `https://api.stone.com.br/v1/disputes`
- Auth: none declared

Retorna uma lista paginada de disputas com base nos filtros fornecidos.

## Query parameters

- `createdAt__lte` union
  - string, date-time
  - string, date
- `createdAt__gte` union
  - string, date-time
  - string, date
- `status` string
- `reason.code` integer
- `network` string
- `cycle` string[]
- `cycleStatus` string[]
- `forwardCursor` string
- `limit` integer

## Response `200`

Lista de disputas retornada com sucesso.

- object
  - `data` Dispute[]
    - `disputeId` string: ID único da disputa.
    - `transactionId` string: ID da transação associada à disputa.
    - `chargeId` string: ID da cobrança associada à disputa.
    - `createdAt` string, date-time: Data da criação da disputa.
    - `updatedAt` string, date-time: Data da última atualização da disputa.
    - `responseDeadline` string, date-time: Data limite para o envio de evidências por parte do lojista.
    - `chargebackAmount` object: Valor do chargeback.
      - `amount` string
      - `currencyCode` string
    - `debitedAmount` object: Valor debitado do lojista.
      - `amount` string
      - `currencyCode` string
    - `status` 'WAITING_MERCHANT_EVIDENCES' | 'WAITING_ACQUIRER_ANALYSIS' | 'MERCHANT_EVIDENCE_DEADLINE_EXPIRED' | 'WAITING_ISSUER' | 'LOST' | 'WON' | 'DEADLINE_EXPIRED' | 'REVERSED': Status atual da disputa. **Valores possíveis:** | Status | Code | Significado | |---|---|---| | `REVERSED` | 93 | Chargeback revertido — o valor contestado foi estornado ao lojista. |
    - `reason` object: Motivo do pedido de chargeback.
      - `code` string: Código do motivo do chargeback.
      - `description` 'FRAUD' | 'PROCESSING_ERROR' | 'COMMERCIAL_DISPUTE' | 'AUTHORIZATION': Descrição do motivo do chargeback.
    - `stage` string: Estágio do ciclo de chargeback.
    - `cycle` 'FIRST' | 'SECOND': Ciclo de chargeback em que a disputa está. O campo é **omitido** da resposta para disputas coletadas antes de o ciclo passar a ser registrado — não é retornado como `null`.
    - `cycleStatus` 'RECEIVED' | 'GUARANTEE_ANALYZED' | 'EVIDENCE_RECEIVED' | 'REPRESENTED' | 'REVERSED' | 'WON' | 'LOST' | 'EXPIRED': Status da disputa dentro do ciclo atual. É independente de `status`, que acompanha o ciclo de vida da disputa como um todo. O campo é **omitido** da resposta para disputas coletadas antes de o ciclo passar a ser registrado — não é retornado como `null`.
    - `network` string: Bandeira do cartão.
    - `institution` 'STONE' | 'PAGAR.ME': Instituição onde a transação foi processado.
    - `events` Event[]: Lista de eventos relacionados à disputa.
      - `type` 'FIRST_CHARGEBACK' | 'FIRST_CHARGEBACK_REVERSED' | 'DISPUTE_NOTIFIED' | 'MERCHANT_EVIDENCE_RECEIVED' | 'EVIDENCE_ANALYSIS_ACCEPTED' | 'EVIDENCE_ANALYSIS_DENIED' | 'LOST_DISPUTE': Tipo do evento relacionado à disputa.
      - `createdAt` string, date-time: Data da criação do evento.
    - `guarantee` object: Resultado da análise de garantia da disputa. O campo é **omitido** da resposta quando a disputa não possui garantia — não é retornado como `null`.
      - `status` string: Situação da garantia (ex.: `GUARANTEED`, `NOT_GUARANTEED`).
      - `reason` string, nullable: Motivo pelo qual a garantia foi negada. É `null` quando a disputa está garantida.
      - `updatedAt` string, date-time: Data da última atualização da análise de garantia. Omitido quando não informado.
  - `page` object
    - `forwardCursor` string, nullable: Identificador para o inicio da próxima página.

## Other responses

- `400`: Parâmetros de filtro inválidos.
- `500`: Erro inesperado ao processar a requisição.

---

[API](https://skmtc.dev/pagar/apis/disputas.md) - [All operations](https://skmtc.dev/pagar/apis/disputas/llms.txt) - [OpenAPI document](https://skmtc.dev/pagar/apis/disputas/revisions/5354c1c3e262?raw)