Disputes

Disputes represent chargebacks filed by customers against charges. When a cardholder disputes a charge with their bank, the dispute is automatically synced to your account. You can upload evidence, submit your case, or accept the dispute.

GET
/api/disputes

List Disputes

Returns all disputes for your account. Use ?state= to filter by PENDING, INQUIRY, WON, or LOST.

curl -X GET "https://api.hlhunt.org/v1/../disputes?state=PENDING&limit=50" \
  -H "Authorization: Bearer sk_live_your_api_key"
GET
/api/disputes/{dispute_id}

Fetch a Dispute

Retrieve a single dispute by ID including its evidence files.

curl -X GET /api/disputes/DSxxxxxxxxxxxxxxxxxx \
  -H "Authorization: Bearer sk_live_your_api_key"
POST
/api/disputes/{dispute_id}/evidence

Upload Evidence

Upload a file as evidence for a dispute. Send as multipart/form-data with a 'file' field. Accepted formats: JPEG, PNG, PDF (max 1MB).

curl -X POST /api/disputes/DSxxxxxxxxxxxxxxxxxx/evidence \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -F "file=@receipt.pdf"
POST
/api/disputes/{dispute_id}/submit

Submit Evidence

Submit all uploaded evidence to the issuing bank for review. This action cannot be undone.

curl -X POST /api/disputes/DSxxxxxxxxxxxxxxxxxx/submit \
  -H "Authorization: Bearer sk_live_your_api_key"
POST
/api/disputes/{dispute_id}/accept

Accept Dispute

Accept (concede) the dispute. The disputed amount will be permanently deducted. This action cannot be undone.

curl -X POST /api/disputes/DSxxxxxxxxxxxxxxxxxx/accept \
  -H "Authorization: Bearer sk_live_your_api_key"