List all refunds

​

Returns a list of refunds, sorted by creation date with the most recent refunds first.

Use the date, status, currency, ID, and pagination parameters to reconcile refund activity or build an operations view.

Refunds are also visible on the related payment in the Merchant Dashboard.

Query Parameters
  • start_date
    Type: string Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • end_date
    Type: string Format: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • status
    Type: array string[]
  • currency
    Type: array string[]
  • limit
    Type: integer

    Integer numbers.

  • last_key
    Type: string

    Opaque cursor for pagination. Use the last_key value from the previous response to retrieve the next page.

  • id
    Type: string
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/refunds
curl https://api.paypercut.io/v1/refunds \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "01K755J9SV2364REVHB915Z2FW",
      "created": "2026-08-27T09:23:50.263Z",
      "updated": "2026-08-27T09:23:50.263Z",
      "currency": {
        "iso": "usd",
        "scale": 2
      },
      "payment": "01K755J9SV2364REVHB915Z2FW",
      "payment_intent": "01K755J9SY55CS04SQ3JX1NX36",
      "status": null,
      "amount": 100,
      "destination_details": {
        "type": "string",
        "card": {
          "reference": "string",
          "reference_status": "string",
          "reference_type": "string",
          "type": "pending"
        }
      },
      "failure_reason": "string",
      "pending_reason": "charge_pending",
      "reason": "duplicate"
    }
  ],
  "last_key": "string"
}

List of refunds