# Get a list of refunds

Endpoint: GET /refunds
Version: 1.37
Security: bearerAuth

## Query parameters:

  - `customerId` (integer)
    Customer identifier
    Example: 1

  - `invoiceId` (integer)
    Invoice identifier
    Example: 1

  - `billRunType` (string)
    Bill Run Type
    Enum: "NORMAL", "ADHOC"

  - `page` (integer, required)
    Page of results to show
    Example: 1

  - `pageSize` (integer, required)
    Results to return per page
    Example: 100

  - `sort` (string)
    Comma-delimited list of the fields to sort by - defaults to ascending order, suffix :desc to change
    Example: "id,name | name:desc"

  - `fields` (string)
    Comma-delimited list of the field(s) to return if only a subset is required
    Example: "id,name"

## Response 200 fields (application/json):

  - `id` (integer)
    Refund identifier
    Example: 1

  - `invoiceId` (integer)
    Invoice identifier
    Example: 1

  - `customerId` (integer)
    Customer identifier
    Example: 1

  - `billRunType` (string)
    Bill run type
    Enum: "NORMAL", "ADHOC"

  - `thirdPartyRefundStatus` (string)
    Third party refund status
    Enum: "CREATED", "PENDING_SUBMISSION", "SUBMITTED", "PAID", "CANCELLED", "BOUNCED", "FUNDS_RETURNED", "MANUALLY_REFUNDED", "REFUND_SETTLED"

  - `description` (string)
    Refund description

  - `errorInfo` (string)
    Error information from third party payment provider

  - `paymentMethod` (string)
    Payment method
    Enum: "CHEQUE", "DIRECT_DEBIT", "CANCELLED_DD", "CANCELLED_CARD", "CREDIT_CARD", "PAYPAL", "BACS", "POST_OFFICE_PAYMENT_CARD", "EZYPAY", "GO_CARDLESS", "GC_INSTANT_BANK_PAYMENTS", "STRIPE", "STRIPE_CARD", "STRIPE_DD", "FINASTRA", "FAST_PAY", "OTHER"

  - `amountInMajorCurrency` (number)
    Amount to refund in major currency (e.g pounds/dollars/euros)
    Example: 10.5


## Response 400 fields

## Response 401 fields

## Response 403 fields