List Disputes

Request

Method & Path

GET /v1/disputes

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer sk_sandbox_...` or `Bearer sk_live_...`

Query Parameters

View query parameters

integer

Number of disputes to return. Min 1, max 100. Default 50.

integer

Number of disputes to skip before returning results. Default 0.

string

Filter by dispute status. Accepted values: needs_response, under_review, won, lost, closed. Case-insensitive.

string

ISO 8601 datetime. Return only disputes created at or after this time.

string

ISO 8601 datetime. Return only disputes created at or before this time.

Example Request

curl "https://api.bachs.io/v1/disputes?status=needs_response&limit=20" \
  -H "Authorization: Bearer sk_live_abc123xyz..."

Response

200 Success

{
  "total": 5,
  "items": [
    {
      "dispute_id": "dsp_3e7b1c9a2f48",
      "charge_id": "ch_8f3a1c9b4e72",
      "amount": "75.00",
      "currency": "USD",
      "status": "needs_response",
      "is_response_editable": true,
      "reason": "fraudulent",
      "response_deadline_at": "2026-03-23T23:59:59.000Z",
      "created_at": "2026-03-09T08:00:00.000Z",
      "updated_at": "2026-03-09T08:00:00.000Z"
    }
  ]
}

Response Fields

View response fields

integer

Total number of disputes matching the query, across all pages.

array

Dispute objects for the current page.

string

Unique identifier for the dispute.

string|null

The payin this dispute is associated with, or null if not resolved to a specific charge.

string

Disputed amount as a decimal string.

string

Currency of the disputed amount, in ISO 4217 format (e.g., USD).

string

Current dispute status. See Dispute Statuses.

boolean

true if you can still update and submit evidence. false after submission or once the deadline passes.

string|null

The reason code for the dispute as reported by the payment network (e.g., fraudulent, product_not_received). null if not yet available.

string|null

ISO 8601 deadline by which you must submit evidence. null if no deadline has been set.

string

ISO 8601 timestamp when the dispute was created.

string

ISO 8601 timestamp of the last update.

Pagination

Use limit and offset to page through results:

# Page 1
curl "https://api.bachs.io/v1/disputes?limit=50&offset=0" \
  -H "Authorization: Bearer sk_live_abc123xyz..."

# Page 2
curl "https://api.bachs.io/v1/disputes?limit=50&offset=50" \
  -H "Authorization: Bearer sk_live_abc123xyz..."

Get Started

Products & pricing

Subscriptions

Customer portal

Payments

Payouts

Dashboard

Developer Portal

CLI

For You and Your Customers

List Disputes

Request

Method & Path

Headers

Query Parameters

Example Request

Response

200 Success

Response Fields

​Request

​Method & Path

​Headers

​Query Parameters

​Example Request

​Response

​200 Success

​Response Fields

​Pagination

​Related

Request

Method & Path

Headers

Query Parameters

Example Request

Response

200 Success

Response Fields

Pagination

Related