# get list of refunds

Endpoint to get list of refunds.


Endpoint: GET /reconciliation/refunds
Version: 3.0.0
Security: JWS-Request-Signature

## Query parameters:

  - `payout-id` (string)
    Payout Id

  - `size` (integer)
    the size of the page to be returned in list requests.

  - `page` (integer)
    zero-based page index in list requests.

  - `start-date` (string)
    The start date (inclusive) in yyyy-MM-dd format for which the list of payments/refunds should be returned. The maximum difference between the start date and end date can be 30 days When the start date is filled the end date needs to be filled as well.

  - `end-date` (string)
    The end date (inclusive) in yyyy-MM-dd format for which the list of payments/refunds should be returned. The maximum difference between the start date and end date can be 30 days. When the end date is filled the start date needs to be filled as well.

## Response 200 fields (application/json):

  - `size` (integer, required)
    the total number of elements in the current page of this response

  - `totalPages` (integer, required)
    the total number of pages in the response

  - `totalElements` (integer, required)
    the total number of elements in the response

  - `number` (integer, required)
    the current page number

  - `refunds` (array, required)
    a list of refunds included in the payout.

  - `refunds.paymentId` (string, required)
    The id of the payment

  - `refunds.payoutId` (string)
    The id of the payout

  - `refunds.paymentProfileId` (string, required)
    The profile id of the merchant used in the transaction

  - `refunds.merchantName` (string, required)
    The name of the merchant

  - `refunds.paymentChannel` (string, required)
    "The  channel of the payment"
    Enum: "ONLINE", "INSTORE", "INVOICE"

  - `refunds.currency` (string, required)
    currency code. Only EUR is supported [ISO 4217](http://en.wikipedia.org/wiki/ISO_4217)
    Enum: "EUR"

  - `refunds.amount` (integer, required)
    Total amount in cents of the transaction

  - `refunds.reference` (string)
    The reference provided by the merchant/partner during a payment/refund

  - `refunds.description` (string)
    The description provided by the merchant/partner during a payment/refund

  - `refunds.transactionDate` (string, required)
    timestamp, when transaction was created in UTC

  - `refunds.refundId` (string, required)
    The id of the refund

## Response 400 fields (application/json):

  - `code` (string, required)
    Error code

  - `message` (string, required)
    Error message

## Response 401 fields (application/json):

  - `code` (string, required)
    Error code

  - `message` (string, required)
    Error message

## Response 403 fields (application/json):

  - `code` (string, required)
    Error code

  - `message` (string, required)
    Error message

## Response 404 fields (application/json):

  - `code` (string, required)
    Error code

  - `message` (string, required)
    Error message

## Response 500 fields (application/json):

  - `code` (string, required)
    Error code

  - `message` (string, required)
    Error message