List refunds

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

{
  "refunds": [
    {
      "id": "PWCR_da1v3j4p3z15y47adpzzq0whj",
      "amount": 2500,
      "currency": "USD",
      "customer_id": "CST_AQmxh4y_QGoNNIG5NUw0jttqyYedL1LklACQdyJ3H-Vs6WmLtP6A_C7XjQNohvY",
      "merchant_id": "MMI_4vxs5egfk7hmta3qx2h6rp91x",
      "status": "AUTHORIZED",
      "created_at": "2022-01-01T12:00:00Z",
      "updated_at": "2022-01-05T12:00:00Z",
      "grant_id": "GRG_221243dc6985a6819ff6950c1a21332f7bc4a46ebd49b5a7002908ab768e8e5ff7831e084d0d2c9d8d939793b55eff50",
      "payment_id": "PWC_4nn21zy6t0v2yhqg5bvhk7xkq",
      "reference_id": "external-id",
      "metadata": {},
      "decline_errors": [
        {
          "category": "API_ERROR",
          "code": "MISSING_REQUIRED_FIELD",
          "detail": "Missing required parameter.",
          "field": "field_a[2].field_b"
        }
      ]
    }
  ],
  "cursor": "string"
}

Returns a list of refunds matching the given query parameters.

This endpoint is rate limited to 100 QPS.

Scopes: REFUNDS_READ

Query parameters

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_idstringOptional1-1024 characters

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

customer_idstringOptional1-128 characters

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

merchant_idstringOptional1-128 characters

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

limitintegerOptional1-100Defaults to 50

Maximum number of refunds to return.

Response

refundslist of objects

List of refunds matching the given query parameters.

cursorstring

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

Errors

400

Bad Request Error

Headers

Query parameters

Response

Errors

Headers

Query parameters

Response

Errors