---
api: 'Merchant API'
---

# Retrieve a disbursement list

Retrieve disbursements from your merchant account. You can also use the query parameters for:

  | Filtering | Pagination |
  | --------- | ---------- |
  | Filter the disbursements that you want to retrieve, for example, only retrieve the disbursements with a specific state. <br/><br/>Parameters used for filtering:<br/><ul><li>`from`</li><li>`to`</li><li>`state`</li></ul> | Control the number of disbursements returned per page. <br/><br/>Parameters used for pagination: <br/><ul><li>`limit`</li><li>`page_token`</li></ul> |

## Endpoint

GET `/api/disbursements`

## Parameters

### query parameters

- `limit` (integer, optional)
  Maximum number of records to return. Used for **pagination**.

- `from` (string, optional)
  Filter records created from this date/time. Used for **filtering**.

- `to` (string, optional)
  Filter records created until this date/time. Used for **filtering**.

- `state` (array of enum, optional)
  Filter disbursements by state. Repeat the parameter to filter by multiple states.

- `page_token` (string, optional)
  Token for retrieving the next page of results. Used for **pagination**.
  
  To paginate through results:
  
    1. Make an initial request with the desired `limit`.
    1. The response will include a `next_page_token` if more results are available.
    1. Use that token in the `page_token` parameter of your next request.
    1. Repeat until `next_page_token` is not present.
  
  :::note
  When using `page_token`, you must include all query parameters from the initial request (such as `from`, `to`, or other filter parameters) to maintain consistent filtering across pages.
  :::

## Returns

### 200

Disbursements retrieved

#### Response attributes

- `next_page_token` (string, optional)
    Token for retrieving the next page of results. Use this token as the value of the `page_token` query parameter in your next request to retrieve the next page.
    
    If not present, there are no more results to retrieve.
- `disbursements` (array of object)
  - `disbursements[].id` (string)
      Permanent disbursement ID used for disbursement operations.
  - `disbursements[].state` (enum)
      The current state of the disbursement.
      
      | State | Description |
      | ----- | ----------- |
      | `pending` | The disbursement has been created and is awaiting processing. |
      | `processing` | The disbursement is being processed by Revolut and the card schemes. |
      | `completed` | The disbursement was successfully sent to the destination. |
      | `declined` | The disbursement could not be completed. When present, the `reason` field explains why. |
      Possible enum values:

      - `pending`
      - `processing`
      - `completed`
      - `declined`
  - `disbursements[].created_at` (string)
      The time the disbursement was created.
  - `disbursements[].updated_at` (string)
      The time the disbursement was last updated.
  - `disbursements[].reason` (enum, optional)
      The reason the disbursement was declined. Only returned when the state is `declined`.
      
      | Value | Description |
      | ----- | ----------- |
      | `merchant_pocket_not_found` | The merchant currency pocket for the disbursement currency was not found. |
      | `insufficient_funds` | The merchant account does not have enough funds for the disbursement currency. |
      | `high_risk` | The disbursement was flagged as high risk. |
      | `unknown` | The disbursement was declined for an unknown reason. |
      | `technical_error` | The disbursement failed due to a technical error. |
      | `pick_up_card` | The card scheme declined the disbursement and requested the card to be picked up. |
      | `do_not_honour` | The card scheme declined the disbursement. |
      | `invalid_amount` | The card scheme rejected the disbursement amount. |
      | `invalid_card` | The card number is invalid. |
      | `expired_card` | The card is expired. |
      | `transaction_not_allowed_for_cardholder` | The cardholder is not allowed to receive this disbursement. |
      | `restricted_card` | The card is restricted and cannot receive disbursements. |
      | `suspected_fraud` | The disbursement is suspected of being fraudulent. |
      | `issuer_not_available` | The card issuer is currently unavailable to authorize the disbursement. |
      | `withdrawal_frequency_exceeded` | The frequency of withdrawals to the card has exceeded the allowed limit. |
      | `law_violation` | The disbursement violates legal regulations. |
      | `security_violation` | The disbursement violates security protocols. |
      | `invalid_transaction` | The disbursement is invalid. |
      | `new_card_not_unblocked` | The new card has not been unblocked by the issuer. |
      | `rejected_by_customer` | The disbursement was rejected by the cardholder. |
      Possible enum values:

      - `merchant_pocket_not_found`
      - `insufficient_funds`
      - `high_risk`
      - `unknown`
      - `technical_error`
      - `pick_up_card`
      - `do_not_honour`
      - `invalid_amount`
      - `invalid_card`
      - `expired_card`
      - `transaction_not_allowed_for_cardholder`
      - `restricted_card`
      - `suspected_fraud`
      - `issuer_not_available`
      - `withdrawal_frequency_exceeded`
      - `law_violation`
      - `security_violation`
      - `invalid_transaction`
      - `new_card_not_unblocked`
      - `rejected_by_customer`
  - `disbursements[].destination` (object)
      The destination the disbursement was sent to.
      
      The response shows the actual destination type, even when the disbursement was created with a `saved_payment_method` destination: a `card` or the customer's Revolut Pay account. 
      
      When the destination is a saved payment method, its `id` is also returned - you can reuse it as the `saved_payment_method` destination in future disbursement requests.
    - `disbursements[].destination.type` (enum)
        The type of the destination the disbursement was sent to.
        
        | Destination type | Description |
        | ---------------- | ----------- |
        | `card` | The disbursement was sent to a card. |
        | `revolut_pay` | The disbursement was sent to the customer's Revolut Pay account. |
        Possible enum values:

        - `card`
        - `revolut_pay`
    - `disbursements[].destination.id` (string, optional)
        Unique identifier for the payment method.
    - `disbursements[].destination.last_four` (string, optional)
        The last four digits of the payment card number.
  - `disbursements[].amount` (integer)
      The amount of the disbursement in minor currency units. For example, `7034` represents €70.34.
  - `disbursements[].currency` (string)
      [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code in upper case.
      
      :::info
      For more information about the supported currencies, see: [Help Center](https://help.revolut.com/business/help/merchant-accounts/payments/in-which-currencies-can-i-accept-payments/).
      :::
  - `disbursements[].reference` (string, optional)
      A custom reference for the disbursement, useful for reconciliation. For example, a withdrawal ID from your system.

## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 500 | Internal Server Error |