Listar disputas
GET
/api/disputes
Autenticação
Bearer pela sua API Key real (vk_live_* produção, vk_test_* sandbox). Crie a chave em https://app.dotfy.com.br/dashboard/chaves-api. Sem o header → 401. Com chave inválida/revogada → 401. Com chave sem o escopo necessário → 403 insufficient_scope.charges:read (compartilha com cobranças).Requisição
Parâmetros Header
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/api/disputes' \
--header 'Authorization: Bearer <token>'Response Response Example
{
"success": true,
"data": [
{
"id": "cldisp0001",
"userId": "cluser0001",
"chargeId": "clcharge0001",
"type": "MED",
"status": "OPENED",
"reason": "Compra não reconhecida pelo cliente",
"value": 50000,
"createdAt": "2026-05-01T10:00:00.000Z",
"endToEndId": "E1823612020260501s00abc",
"claimantName": "Cliente reclamante",
"claimantEmail": "reclamante@exemplo.com",
"claimantTaxId": "11122233344",
"defenseStatus": "NO_DEFENSE",
"defenseText": null,
"defenseSubmittedAt": null,
"charge": {
"id": "clcharge0001",
"correlationId": "dotfy-1714000000000-abc12345",
"value": 50000,
"customerName": "Maria Silva",
"userId": "cluser0001"
},
"_count": {
"evidences": 0
}
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 8,
"totalPages": 1
}
}Modificado em 2026-07-02 06:57:27