> ## Documentation Index > Fetch the complete documentation index at: https://docs.purin.cash/llms.txt > Use this file to discover all available pages before exploring further. # Get Dispute > Uma disputa pelo ID, com as provas enviadas, a situação da defesa e a linha do tempo dos status (os mesmos eventos enviados por webhook). Precisa da permissão disputas.gerenciar. No sandbox retorna 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.purin.cash 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: Subcontas description: Ledger de saldo por cliente do integrador. - 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: >- Uma disputa pelo ID, com as provas enviadas, a situação da defesa e a linha do tempo dos status (os mesmos eventos enviados por webhook). Precisa da permissão disputas.gerenciar. No sandbox retorna 404. operationId: getDispute parameters: - $ref: '#/components/parameters/DisputeId' responses: '200': description: A disputa. content: application/json: schema: allOf: - $ref: '#/components/schemas/Dispute' - type: object properties: history: type: array description: Cada mudança de status, na ordem. items: type: object properties: event: type: string enum: - dispute.opened - dispute.under_review - dispute.won - dispute.lost from: type: - string - 'null' description: Status anterior (null na abertura). to: type: string description: Status novo. at: type: string format: date-time '400': description: ID em formato inválido. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid dispute ID format '403': $ref: '#/components/responses/SemPermissao' '404': description: Disputa não encontrada, de outra conta, ou chave de sandbox. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Dispute not found '500': $ref: '#/components/responses/ErroInterno' components: parameters: DisputeId: name: id in: path required: true description: ID da disputa (o id de GET /v1/disputes). schema: type: string schemas: Dispute: type: object description: Disputa (MED) aberta contra a conta. properties: id: type: string description: ID da disputa. code: type: string description: Código legível da disputa (o mesmo do painel). status: type: string enum: - aberta - pendente - resolvida - perdida description: >- aberta: aceita resposta. pendente: em análise no banco. resolvida: ganha. perdida: decidida a favor do pagador. statusLabel: type: string enum: - aberta - em análise - ganha - perdida canRespond: type: boolean description: true quando aceita resposta agora (aberta e já registrada no banco). amount: type: number description: Valor contestado em reais. currency: type: string enum: - BRL reason: type: string description: Motivo informado pelo banco do pagador. providerDisputeId: type: string description: >- Identificador da contestação no banco. Pode vir vazio logo depois da abertura. endToEndId: type: string description: Identificador end-to-end do PIX contestado. orderCode: type: string description: Código do pedido ou da cobrança contestada. buyer: type: string description: Nome de usuário do comprador (vendas pelo Discord). buyerDiscordId: type: string product: type: string subAccountId: type: string description: Subconta da venda quando houver.: null defense: type: object properties: sentAt: type: - string - 'null' format: date-time description: Quando a última defesa chegou ao banco. failedAt: type: - string - 'null' format: date-time description: Quando a última tentativa de envio falhou. failReason: type: string description: Motivo da última falha. evidences: type: array description: >- Provas enviadas. Os links das provas guardadas aqui são assinados e expiram; consulte de novo para um link válido. items: type: object properties: url: type: string description: type: string correlationID: type: string uploadedAt: type: - string - 'null' format: date-time resolvedAt: type: - string - 'null' format: date-time createdAt: type: string format: date-time updatedAt: type: string format: date-time Error: type: object properties: error: type: string description: >- Mensagem de erro legivel. Trate pelo codigo HTTP; o texto pode mudar. responses: SemPermissao: description: A chave não tem a permissão disputas.gerenciar. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: This API key does not have the "Gerenciar disputas" permission. ErroInterno: description: Erro interno. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Internal error securitySchemes: bearerAuth: type: http scheme: bearer description: Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.