# List refunds

Endpoint: GET /v1/refunds
Version: 2.0.0
Security: oAuth2

## Query parameters:

  - `chargeId` (string)

  - `status` (string)
    Enum: "pending", "succeeded", "failed"

  - `limit` (integer)

  - `cursor` (string)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.refundId` (string, required)
    Example: "rfd_01JH..."

  - `items.chargeId` (string, required)

  - `items.amount` (number, required)

  - `items.currency` (string)

  - `items.status` (string, required)
    Enum: "pending", "succeeded", "failed"

  - `items.reason` (string)
    Enum: "duplicate", "fraudulent", "requested_by_customer", "other"

  - `items.createdAt` (string, required)

  - `pagination` (object)

  - `pagination.nextCursor` (string,null)
    Example: "cursor_abc123"