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

# Lista disputas de chargeback

`GET /v1/disputes`

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

## Query parameters

- `createdAt__lte` string, date-time
- `createdAt__gte` string, date-time
- `status` string
- `reason.code` integer
- `network` string
- `forwardCursor` string
- `limit` integer

## Response `200`

Lista de disputas retornada com sucesso.

- object
  - `data` Dispute[]
    - `disputeId` integer — ID único da disputa.
    - `transactionId` integer — ID da transação 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' — Status atual da disputa.
    - `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.
    - `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' | '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.
  - `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.net/pagar/apis/pagarme-api.md) · [All operations](https://skmtc.net/pagar/apis/pagarme-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagar/pagarme-api/revisions/dababf062743/schema)