---
title: "Consulta uma disputa específica"
method: GET
path: "/v1/disputes/{dispute_id}"
tags: ["Disputas"]
---

# Consulta uma disputa específica

`GET /v1/disputes/{dispute_id}`

## Request

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

## Path parameters

- `dispute_id` string, required

## Response `200`

Detalhes da disputa encontrados.

- 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.

## Other responses

- `404`: Disputa não encontrada.
- `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)