> ## 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. # List Disputes > Lista as disputas (MED, o Mecanismo Especial de Devolução) da conta, das mais recentes para as mais antigas. Enquanto uma disputa está aberta ou foi perdida, o valor contestado fica retido do saldo sacável (campo disputeBlocked do GET /v1/wallet). Precisa da permissão disputas.gerenciar. No sandbox retorna lista vazia com "sandbox": true. ## OpenAPI ````yaml /api-reference/openapi.yaml get /v1/disputes 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: get: tags: - Disputas summary: List Disputes description: >- Lista as disputas (MED, o Mecanismo Especial de Devolução) da conta, das mais recentes para as mais antigas. Enquanto uma disputa está aberta ou foi perdida, o valor contestado fica retido do saldo sacável (campo disputeBlocked do GET /v1/wallet). Precisa da permissão disputas.gerenciar. No sandbox retorna lista vazia com "sandbox": true. operationId: listDisputes parameters: - name: limit in: query required: false description: Disputas por página (1 a 100). schema: type: integer minimum: 1 maximum: 100 default: 50 - name: offset in: query required: false description: Quantas disputas pular (paginação). schema: type: integer minimum: 0 default: 0 - name: status in: query required: false description: >- Um status ou vários separados por vírgula (ex.: aberta,pendente). Aceita aberta, pendente, resolvida e perdida. Valor fora da lista retorna 400. schema: type: string example: aberta,pendente - name: orderCode in: query required: false description: Só as disputas do pedido com esse código. schema: type: string - name: endToEndId in: query required: false description: Só as disputas do PIX com esse identificador end-to-end. schema: type: string - name: from in: query required: false description: Data inicial da abertura (ISO 8601). schema: type: string format: date-time - name: to in: query required: false description: Data final da abertura (ISO 8601). schema: type: string format: date-time responses: '200': description: Lista de disputas. content: application/json: schema: type: object properties: disputes: type: array items: $ref: '#/components/schemas/Dispute' total: type: integer description: Total de disputas que atendem aos filtros. limit: type: integer offset: type: integer sandbox: type: boolean description: Presente (true) só no sandbox. '400': description: Filtro inválido (status fora da lista ou data inválida). content: application/json: schema: $ref: '#/components/schemas/Error' example: error: >- Invalid status: ganha. Use: aberta, pendente, resolvida, perdida '403': $ref: '#/components/responses/SemPermissao' '500': $ref: '#/components/responses/ErroInterno' components: 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.