List all disputes - WooshPay OpenAPI

Returns a list of your disputes.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string {{Username}}:{{Password}}

Example:

Authorization: Basic YWRtaW46MTIzNDU2

Header Params

string

required

Default:

application/json

Content-Type

string

required

Default:

application/json

Body Params application/json

charge

string

optional

Only return disputes associated to the charge specified by this charge ID.

payment_intent

string

optional

Only return disputes associated to the PaymentIntent specified by this PaymentIntent ID.

created

object

optional

A filter on the list based on the object created field. The value can be a string with an integer Unix timestamp, or it can be a dictionary with the following options:

integer

optional

Return results where the created field is greater than this value.

gte

integer

optional

Return results where the created field is greater than or equal to this value.

string

optional

Return results where the created field is less than this value.

lte

integer

optional

Return results where the created field is less than or equal to this value.

ending_before

string

optional

A cursor for use in pagination. ending_before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_bar, your subsequent call can include ending_before=obj_bar in order to fetch the previous page of the list.

limit

integer

optional

A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.

starting_after

string

optional

A cursor for use in pagination. starting_after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include starting_after=obj_foo in order to fetch the next page of the list.

Example

{
  "charge": "string",
  "payment_intent": "string",
  "created": {
    "gt": 0,
    "gte": 0,
    "lt": "string",
    "lte": 0
  },
  "ending_before": "string",
  "limit": 0,
  "starting_after": "string"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

object

string

optional

url

string

optional

has_more

boolean

optional

data

array [object {15}]

optional

string

optional

object

string

optional

amount

integer

optional

balance_transactions

array[string]

optional

charge

string

optional

created

integer

optional

currency

string

optional

evidence

object

optional

evidence_details

object

optional

is_charge_refundable

boolean

optional

livemode

boolean

optional

metadata

object

optional

payment_intent

null

optional

reason

string

optional

status

string

optional

Example

{
  "object": "list",
  "url": "/v1/disputes",
  "has_more": false,
  "data": [
    {
      "id": "dp_1M97r8L6kclEVx6M2LpvSCG3",
      "object": "dispute",
      "amount": 1000,
      "balance_transactions": [],
      "charge": "ch_3K5l24L6kclEVx6M0ls3dCrx",
      "created": 1669643926,
      "currency": "eur",
      "evidence": {
        "access_activity_log": null,
        "billing_address": null,
        "cancellation_policy": null,
        "cancellation_policy_disclosure": null,
        "cancellation_rebuttal": null,
        "customer_communication": null,
        "customer_email_address": null,
        "customer_name": null,
        "customer_purchase_ip": null,
        "customer_signature": null,
        "duplicate_charge_documentation": null,
        "duplicate_charge_explanation": null,
        "duplicate_charge_id": null,
        "product_description": null,
        "receipt": null,
        "refund_policy": null,
        "refund_policy_disclosure": null,
        "refund_refusal_explanation": null,
        "service_date": null,
        "service_documentation": null,
        "shipping_address": null,
        "shipping_carrier": null,
        "shipping_date": null,
        "shipping_documentation": null,
        "shipping_tracking_number": null,
        "uncategorized_file": null,
        "uncategorized_text": null
      },
      "evidence_details": {
        "due_by": 1671321599,
        "has_evidence": false,
        "past_due": false,
        "submission_count": 0
      },
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": {},
      "payment_intent": null,
      "reason": "general",
      "status": "warning_needs_response"
    }
  ]
}