POST
/
v2
/
refunds
/
list
Refunds - List
curl --request POST \
  --url https://sandbox.hyperswitch.io/v2/refunds/list \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "start_time": "2023-11-07T05:31:56Z",
  "end_time": "2023-11-07T05:31:56Z",
  "payment_id": "<string>",
  "refund_id": "<string>",
  "limit": 123,
  "offset": 123,
  "amount_filter": {
    "start_amount": 123,
    "end_amount": 123
  },
  "connector": [
    "<string>"
  ],
  "connector_id_list": [
    "<string>"
  ],
  "currency": [
    "AED"
  ],
  "refund_status": [
    "succeeded"
  ]
}'
{
  "count": 1,
  "total_count": 123,
  "data": [
    {
      "id": "<string>",
      "payment_id": "<string>",
      "merchant_reference_id": "ref_mbabizu24mvu3mela5njyhpit4",
      "amount": 6540,
      "currency": "AED",
      "status": "succeeded",
      "reason": "<string>",
      "metadata": {},
      "error_details": {
        "code": "<string>",
        "message": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "connector": "authipay",
      "profile_id": "<string>",
      "merchant_connector_id": "<string>",
      "connector_refund_reference_id": "<string>"
    }
  ]
}

Authorizations

​
api-key
string
header
required

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Body

application/json

A type representing a range of time for filtering, including a mandatory start time and an optional end time.

Response

200 - application/json

List of refunds

The response is of type object.