Get Dispute

Request

Method & Path

GET /v1/disputes/{dispute_id}

Headers

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

Path Parameters

View path parameters

string

required

The unique identifier for the dispute.

Example Request

curl https://api.bachs.io/v1/disputes/dsp_3e7b1c9a2f48 \
  -H "Authorization: Bearer sk_live_abc123xyz..."

Response

200 Success

{
  "dispute_id": "dsp_3e7b1c9a2f48",
  "charge_id": "ch_8f3a1c9b4e72",
  "amount": "75.00",
  "currency": "USD",
  "status": "under_review",
  "is_response_editable": false,
  "reason": "fraudulent",
  "response_deadline_at": "2026-03-23T23:59:59.000Z",
  "evidence": {
    "billing_address": "14 Broad Street, Lagos, Nigeria",
    "cancellation_policy_disclosure": null,
    "customer_email_address": "customer@example.com",
    "customer_name": "Amara Osei",
    "notes": "Customer confirmed delivery via email on March 5.",
    "product_description": "Annual SaaS subscription, plan ID PLAN-PRO-001",
    "refund_policy_disclosure": null,
    "refund_refusal_explanation": "Service was fully rendered and confirmed by the customer.",
    "service_date": "2026-03-01",
    "access_activity_log": null,
    "cancellation_policy_attachment_id": null,
    "customer_communication_attachment_id": "upl_9f2c7b3d1e45",
    "refund_policy_attachment_id": null,
    "uncategorized_attachment_id": null
  },
  "latest_submission": {
    "submission_id": "dse_a1b2c3d4e5f6",
    "status": "submitted",
    "trigger_source": "merchant_submit",
    "submitted_at": "2026-03-10T09:15:00.000Z",
    "failed_at": null,
    "attempt_sequence": 1
  },
  "created_at": "2026-03-09T08:00:00.000Z",
  "updated_at": "2026-03-10T09:15:00.000Z"
}

Response Fields

View response fields

string

Unique identifier for this 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. Becomes false permanently once you submit.

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. Submitting after this timestamp returns a 410 error. null if no deadline has been set.

object

The current state of your evidence draft. All fields are null until you set them via Update Dispute Evidence.

string|null

Customer’s billing address.

string|null

Your cancellation policy as presented to the customer.

string|null

Email address of the customer.

string|null

Full name of the customer.

string|null

Freeform notes to support your response.

string|null

Description of the product or service delivered.

string|null

Your refund policy as presented to the customer.

string|null

Explanation of why a refund was not issued.

string|null

Date the service was rendered or the product was delivered (e.g., 2026-03-01).

string|null

An access or activity log showing the customer used what they paid for.

string|null

document_id of your cancellation policy document.

string|null

document_id of your refund policy document.

string|null

document_id of a supporting file uploaded via Upload Dispute Document.

string|null

document_id of a file showing communication with the customer (e.g., a screenshot of email or chat).

object|null

Metadata for the most recent submission attempt. null if you have not submitted yet.

string

Unique identifier for this submission attempt.

string

Submission outcome: submitted (evidence was delivered) or failed (delivery failed).

string

What triggered the submission: merchant_submit (you called Submit Dispute) or admin_retrigger.

string|null

ISO 8601 timestamp when the evidence was successfully delivered. null if the attempt failed.

string|null

ISO 8601 timestamp when the attempt failed. null if the attempt succeeded.

integer

Sequential attempt number, starting at 1. Increments on each re-submission attempt.

string

ISO 8601 timestamp when the dispute was created.

string

ISO 8601 timestamp of the last update.

Errors

Status	Error Code	Cause
`404`	`NOT_FOUND`	Dispute not found, or belongs to a different organization or environment.

Get Started

Products & pricing

Subscriptions

Customer portal

Payments

Payouts

Dashboard

Developer Portal

CLI

For You and Your Customers

Request

Method & Path

Headers

Path Parameters

Example Request

Response

200 Success

Response Fields

Errors

​Request

​Method & Path

​Headers

​Path Parameters

​Example Request

​Response

​200 Success

​Response Fields

​Errors

​Related

Request

Method & Path

Headers

Path Parameters

Example Request

Response

200 Success

Response Fields

Errors

Related