List disputes

Retrieves a list of disputes

GET /dispute/list

Try it

List disputes

cURL

curl --request GET \
  --url https://api.pushcash.com/dispute/list \
  --header 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": "dispute_0293cj9ru032lisdjow",
      "amount": 10000,
      "currency": "USD",
      "created_at": "2023-05-24T20:36:50.694Z",
      "intent_id": "intent_sandbox_dMggQ93ZYH6DH9LBhVeijE",
      "code": "R01",
      "status": "created",
      "type": "push"
    }
  ],
  "next_cursor": "vjl8vk3l4o8dhsjlzh=="
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

created_at.after · string<date-time>

Return disputes created after this ISO 8601 timestamp.

created_at.before · string<date-time>

Return disputes created before this ISO 8601 timestamp.

status · enum<string>[]

Return disputes which match the provided statuses.

The status of the dispute

Available options: created, won, lost

code · enum<string>[]

Filter disputes by code. Provide multiple values to query disputes with any of the provided codes.

The associated network code for the exception

Available options: 10.1, 10.2, 10.3, 10.4, 10.5, 11.1, 11.2, 11.3, 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 12.7, 13.1, 13.2, 13.3, 13.4, 13.5, 13.6, 13.7, 13.8, 13.9, 4837, 4840, 4849, 4863, 4870, 4871, 4807, 4808, 4812, 4834, 4831, 4842, 4846, 4850, 4999, 4853, 4841, 4854, 4855, 4859, 4860, R01, R02, R03, R04, R05, R06, R07, R08, R09, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31, R32, R33, R34, R35, R36, R37, R38, R39, R40, R41, R42, R43, R44, R45, R46, R47, R50, R51, R52, R53, R61, R62, R67, R68, R69, R70, R71, R72, R73, R74, R75, R76, R77, R80, R81, R82, R83, R84, R85

type · enum<string>

Filter by payment flow type on the associated intent

Available options: push, card_only

cursor · string

The cursor for the next page of results to fetch

Example:

"vjl8vk3l4o8dhsjlzh=="

Response

200

application/json

Successful operation

data · object[] · required

Show child attributes

data. id · string · required

The unique identifier assigned by Push

data. amount · integer · required

Amount for the transaction, in smallest unit of specified currency (ie if currency is USD, the unit would be cents)

data. currency · enum<string> · required

Currency associated with the amount

Available options: USD

data. created_at · string<date-time> · required

When the dispute was created (ISO 8061 date string)

data. intent_id · string · required

The intent which corresponds to the dispute

data. code · enum<string> · required

The associated network code for the exception

Available options: 10.1, 10.2, 10.3, 10.4, 10.5, 11.1, 11.2, 11.3, 12.1, 12.2, 12.3, 12.4, 12.5, 12.6, 12.7, 13.1, 13.2, 13.3, 13.4, 13.5, 13.6, 13.7, 13.8, 13.9, 4837, 4840, 4849, 4863, 4870, 4871, 4807, 4808, 4812, 4834, 4831, 4842, 4846, 4850, 4999, 4853, 4841, 4854, 4855, 4859, 4860, R01, R02, R03, R04, R05, R06, R07, R08, R09, R10, R11, R12, R13, R14, R15, R16, R17, R18, R19, R20, R21, R22, R23, R24, R25, R26, R27, R28, R29, R30, R31, R32, R33, R34, R35, R36, R37, R38, R39, R40, R41, R42, R43, R44, R45, R46, R47, R50, R51, R52, R53, R61, R62, R67, R68, R69, R70, R71, R72, R73, R74, R75, R76, R77, R80, R81, R82, R83, R84, R85

data. status · enum<string> · required

The status of the dispute

Available options: created, won, lost

data. type · enum<string> · required

The payment flow type for the intent associated with the dispute

Available options: push, card_only

next_cursor · string | null · required

Use cursor for paginating list endpoints in conjunction with the cursor request parameter.

In a response, the value is null if there are no more results to fetch.

Example:

"vjl8vk3l4o8dhsjlzh=="