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

# Get Dispute

> Consulta os detalhes de uma disputa pelo ID, incluindo as evidências já enviadas (com URLs assinadas regeneradas a cada consulta). No sandbox retorna sempre 404.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/disputes/{id}
openapi: 3.1.0
info:
  title: PurinCash API
  version: 1.0.0
servers:
  - url: https://api.purincash.com
    description: Produção
security:
  - bearerAuth: []
tags:
  - name: Cartao
    description: Pagamentos no cartao de credito.
  - name: Cobrancas
    description: Cobrancas PIX avulsas com valor livre.
  - name: Entregas
    description: Conteudo entregue automaticamente apos o pagamento.
  - name: Disputas
    description: Contestacoes (MED) e envio de evidencias.
  - name: Pagamentos
    description: Pagamentos PIX e LTC vinculados ou nao a um produto.
  - name: Saques
    description: Saques em PIX, LTC e USDT.
  - name: Produtos
    description: Produtos de cobranca criados pela API.
  - name: Sandbox
    description: Simulacao de pagamentos e saldo de teste.
  - name: Splits
    description: Cobrancas divididas entre varias contas.
  - name: Loja
    description: Produtos da loja do Discord (somente leitura).
  - name: Assinaturas
    description: PIX recorrente.
  - name: Carteira
    description: Saldo, retencoes e valores a liberar.
paths:
  /v1/disputes/{id}:
    get:
      tags:
        - Disputas
      summary: Get Dispute
      description: >-
        Consulta os detalhes de uma disputa pelo ID, incluindo as evidências já
        enviadas (com URLs assinadas regeneradas a cada consulta). No sandbox
        retorna sempre 404.
      operationId: getDispute
      parameters:
        - name: id
          in: path
          required: true
          description: ID da disputa.
          schema:
            type: string
      responses:
        '200':
          description: Detalhes da disputa.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Dispute'
              example:
                id: 665f1a2b3c4d5e6f7a8b9c0d
                code: MED-2024-001
                wooviDisputeId: abc123
                endToEndId: E12345678202603181000
                orderCode: JUE7Y9MPSX
                buyer: João Silva
                buyerDiscordId: ''
                product: Premium Plan
                amount: 23.07
                reason: Produto não recebido
                status: aberta
                evidences:
                  - url: >-
                      https://api.purincash.com/uploads/disputes/665f1a2b3c4d5e6f7a8b9c0d/explicacao-1710763200000.pdf?sig=...
                    description: Explicação da contestação
                    correlationID: MED-2024-001-PDF
                    uploadedAt: '2026-03-18T12:00:00.000Z'
                resolvedAt: null
                createdAt: '2026-03-18T10:00:00.000Z'
        '400':
          description: ID de disputa em formato inválido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Invalid dispute ID format
        '404':
          description: Disputa não encontrada. No sandbox este endpoint retorna sempre 404.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Dispute not found
        '500':
          description: Erro interno.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error: Internal error
components:
  schemas:
    Dispute:
      type: object
      description: Disputa (MED) registrada contra a loja.
      properties:
        id:
          type: string
          description: ID da disputa.
        code:
          type: string
          description: Código interno da disputa (formato MED-...).
        wooviDisputeId:
          type: string
          description: ID da disputa no gateway (vazio quando não houver).
        endToEndId:
          type: string
          description: >-
            Identificador end-to-end da transação PIX contestada (vazio quando
            não houver).
        orderCode:
          type: string
          description: Código do pedido relacionado (vazio quando não houver).
        buyer:
          type: string
          description: Nome do comprador.
        buyerDiscordId:
          type: string
          description: Discord ID do comprador (vazio quando não houver).
        product:
          type: string
          description: Produto relacionado à disputa.
        amount:
          type: number
          description: >-
            Valor contestado em BRL. Enquanto a disputa estiver aberta ou
            perdida (não perdoada), esse valor é retido do saldo sacável (campo
            disputeBlocked do GET /v1/wallet).
        reason:
          type: string
          description: Motivo da disputa.
        status:
          type: string
          enum:
            - aberta
            - resolvida
            - perdida
          description: Status da disputa.
        evidences:
          type: array
          description: >-
            Evidências já enviadas. As URLs são assinadas e regeneradas a cada
            consulta (expiram após o período de validade).
          items:
            type: object
            properties:
              url:
                type: string
                description: URL assinada do documento (com expiração).
              description:
                type: string
                description: Descrição do documento.
              correlationID:
                type: string
                description: Identificador da evidência.
              uploadedAt:
                type: string
                format: date-time
                description: Data de envio da evidência.
        resolvedAt:
          type:
            - string
            - 'null'
          format: date-time
          description: Data de resolução da disputa (null enquanto aberta).
        createdAt:
          type: string
          format: date-time
          description: Data de criação da disputa.
    Error:
      type: object
      properties:
        error:
          type: string
          description: >-
            Mensagem de erro legivel. Trate pelo codigo HTTP; o texto pode
            mudar.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).

````