List refunds

Returns a list of refunds matching the given query parameters.

This endpoint is rate limited to 100 QPS.

Scopes: REFUNDS_READ

cursorstringOptional>=1 character

A pagination cursor returned by a previous call to this endpoint. Provide this cursor to retrieve the next set of results for the original query.

reference_idstringOptional>=1 character<=1024 characters

Filters results to only include refunds with a reference_id matching the given value.

customer_idstringOptional>=1 character<=128 characters

Filters results to only include refunds made to a customer that matches the the given ID.

merchant_idstringOptional>=1 character<=128 characters

Filters results to only include refunds made by a merchant that matches the given ID.

limitintegerOptional>=1<=100Defaults to 50

Maximum number of refunds to return.

refundslist of objects

List of refunds matching the given query parameters.

cursorstring or null

The pagination cursor to be used in a subsequent request. If empty, this is the final response.

1	curl https://api.cash.app/network/v1/refunds \
2	-H "Accept: Accept" \
3	-H "X-Region: X-Region" \
4	-H "X-Signature: X-Signature" \
5	-H "User-Agent: User-Agent"

1	{
2	"refunds": [
3	{
4	"id": "PWCR_da1v3j4p3z15y47adpzzq0whj",
5	"amount": 2500,
6	"currency": "USD",
7	"customer_id": "CST_AQmxh4y_QGoNNIG5NUw0jttqyYedL1LklACQdyJ3H-Vs6WmLtP6A_C7XjQNohvY",
8	"merchant_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
9	"status": "AUTHORIZED",
10	"created_at": "2022-01-01T12:00:00Z",
11	"updated_at": "2022-01-05T12:00:00Z",
12	"grant_id": "GRG_221243dc6985a6819ff6950c1a21332f7bc4a46ebd49b5a7002908ab768e8e5ff7831e084d0d2c9d8d939793b55eff50",
13	"payment_id": "PWC_4nn21zy6t0v2yhqg5bvhk7xkq",
14	"reference_id": "external-id",
15	"metadata": {},
16	"decline_errors": [
17	{
18	"category": "API_ERROR",
19	"code": "MISSING_REQUIRED_FIELD",
20	"detail": "Missing required parameter.",
21	"field": "field_a[2].field_b"
22	}
23	]
24	}
25	],
26	"cursor": "string"
27	}