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

# Retrieve a disbursement

Retrieve the details of a disbursement. Provide the unique disbursement ID, and the corresponding disbursement information is returned.

## Endpoint

GET `/api/disbursements/{disbursement_id}`

## Returns

### 200

Disbursement retrieved

#### Response attributes

- `id` (string)
    Permanent disbursement ID used for disbursement operations.
- `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`
- `created_at` (string)
    The time the disbursement was created.
- `updated_at` (string)
    The time the disbursement was last updated.
- `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`
- `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.
  - `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`
  - `destination.id` (string, optional)
      Unique identifier for the payment method.
  - `destination.last_four` (string, optional)
      The last four digits of the payment card number.
- `amount` (integer)
    The amount of the disbursement in minor currency units. For example, `7034` represents €70.34.
- `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/).
    :::
- `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 |
| 404 | Not Found |
| 500 | Internal Server Error |