List Disputes
Suggest Edits
Overview
Retrieve a list of all payment disputes (chargebacks). This endpoint allows you to query and filter disputes by various criteria including transfer ID, state, and amount.
Resource Access
Production (api.ahrvo.network)
GET https://api.ahrvo.network/payments/na/disputes
Staging (gateway.ahrvo.network)
GET http://gateway.ahrvo.network/payments/na/disputes
Arguments
| Attribute | Mandatory / Optional | Description |
|---|---|---|
limit | Optional | The number of items to return |
transfer_id | Optional | Filter by the ID of the Transfer being disputed |
state | Optional | Filter by the state of the Dispute (PENDING, WON, LOST, INQUIRY) |
amount.gte | Optional | Filter by an amount greater than or equal to (in cents) |
after_cursor | Optional | Return every resource created after the cursor value |
Example Request
curl -X GET "https://gateway.ahrvo.network/payments/na/disputes?limit=10&state=PENDING" \
-H "Content-Type: application/json" \
-H "Authorization: Basic <base64_encoded_credentials>"
Example Response
{
"_embedded": {
"disputes": [
{
"id": "DPxxxxxxxxxxxxxxxxxx",
"created_at": "2025-12-08T14:30:00Z",
"updated_at": "2025-12-08T14:30:00Z",
"amount": 50000,
"transfer": "TRxxxxxxxxxxxxxxxxxx",
"reason": "FRAUD",
"respond_by": "2025-12-22T23:59:59Z",
"state": "PENDING",
"response_state": "NEEDS_RESPONSE",
"evidence_submitted": "CHARGEBACK",
"tags": {
"order_id": "ORDER-12345"
},
"_links": {
"self": {
"href": "https://api.ahrvo.network/payments/na/disputes/DPxxxxxxxxxxxxxxxxxx"
},
"transfer": {
"href": "https://api.ahrvo.network/payments/na/transfers/TRxxxxxxxxxxxxxxxxxx"
}
}
},
{
"id": "DPyyyyyyyyyyyyyyyyyy",
"created_at": "2025-12-07T10:15:00Z",
"updated_at": "2025-12-07T16:20:00Z",
"amount": 25000,
"transfer": "TRyyyyyyyyyyyyyyyyyy",
"reason": "PRODUCT_NOT_RECEIVED",
"respond_by": "2025-12-21T23:59:59Z",
"state": "PENDING",
"response_state": "RESPONDED",
"evidence_submitted": "CHARGEBACK",
"tags": {},
"_links": {
"self": {
"href": "https://api.ahrvo.network/payments/na/disputes/DPyyyyyyyyyyyyyyyyyy"
},
"transfer": {
"href": "https://api.ahrvo.network/payments/na/transfers/TRyyyyyyyyyyyyyyyyyy"
}
}
}
]
},
"page": {
"offset": 0,
"limit": 10,
"count": 2
},
"_links": {
"self": {
"href": "https://api.ahrvo.network/payments/na/disputes?limit=10&state=PENDING"
}
}
}
Understanding Dispute States
State Values
- PENDING: Dispute is active and awaiting resolution
- WON: Merchant successfully defended the dispute
- LOST: Dispute was decided in favor of the cardholder
- INQUIRY: Initial inquiry stage before formal chargeback
Response State Values
- NEEDS_RESPONSE: Evidence needs to be submitted
- ACCEPTED: Merchant accepted the dispute
- RESPONDED: Evidence has been submitted to the bank