---
title: "Index reservations on an account. Version 2022-07-18"
method: GET
path: "/v1/accounts/{account_id}/reservations"
tags: ["Reservations"]
---

# Index reservations on an account. Version 2022-07-18

`GET /v1/accounts/{account_id}/reservations`

Returns an array containing all outstanding reservations on the account specified in the request URL. The API will not return reservations that have been applied or revoked.<br> **Important** This endpoint replaces the [old version](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/#tag/Reservations/paths/~1v1~1accounts~1{account_id}~1reservations~1old/get). However, please note that you have to set the `api-version` header to the version you want (e.g., `2022-07-18`). If you do not specify a version, then the API will return the older version of the response.

## Path parameters

- `account_id` string, required

## Query parameters

- `page[number]` string
- `page[size]` string
- `filter[type]` 'CardAuthorization' | 'SepaCreditTransfer' | 'ClearingTransaction' | 'IntraCustomerTransfer' | 'SepaCreditBatch' | 'Seizure' | 'SecuritiesPurchase' | 'PendingTrade' | 'SEPAInstantCreditTransfer'
- `filter[id]` string
- `filter[status]` 'OPEN' | 'RESOLVED'
- `sort` 'created_at' | '-created_at'

## Response `200`

Successfully fetched the reservations.

- object[] — An array containing all open reservations for the account.
  - `id` string — ID of the reservation.
  - `description` string — A description for the reservation, which is visible to the customer.
  - `account_id` string — ID of the account to which the reservation is attached.
  - `iban` string — IBAN of the account to which the reservation is attached.
  - `amount` object — The amount of the reservation, in Euro cents.
    - `value` integer
    - `unit` string
    - `currency` string
  - `type` 'CardAuthorization' | 'SepaCreditTransfer' | 'ClearingTransaction' | 'IntraCustomerTransfer' | 'SepaCreditBatch' | 'Seizure' | 'SecuritiesPurchase' | 'PendingTrade' | 'SEPAInstantCreditTransfer'
  - `reference` string — Internal reference number for the reservation.
  - `status` 'OPEN' | 'RESOLVED' — The current status of the reservation. Possible values are `OPEN` and `RESOLVED`.
  - `meta_info` ReservationsMetaInfo — An object containing all meta information related to the reservation.
    - `card_id` string — Solaris ID of the card used to create the reservation.
    - `merchant` object — Object containing all metadata related to the merchant with whom the transaction was conducted.
      - `id` string — The ID that the merchant provided to their acquirer.
      - `country_code` string — Two-letter code of the country where the merchant is based.
      - `category_code` string — The [Merchant Category Code (MCC)](https://www.citibank.com/tts/solutions/commercial-cards/assets/docs/govt/Merchant-Category-Codes.pdf) of the merchant.
      - `post_code` string — Postal code where the merchant is based.
      - `state` string — State where the merchant is based.
      - `street_address` string — Street address of the merchant.
      - `name` string — The name of the merchant.
      - `town` string — Town where the merchant is based.
    - `original_amount` object — The amount of the reservation (in Euro cents) combined with the foreign exchange rate.
      - `currency` string
      - `value` integer
      - `fx_rate` integer
    - `pos_entry_mode` 'CARD_NOT_PRESENT' | 'CHIP' | 'CONTACTLESS' | 'MAG_STRIPE' — The POS entry mode used for the reservation.
    - `trace_id` string — ID used to link the authorization and the settlement. Note that Solaris cannot guarantee that this will always match.
    - `transaction_date` string — Date when the transaction occurred.
    - `transaction_time` string — Date and time when the transaction occurred (UTC format).
    - `transaction_type` 'PURCHASE' | 'ATM_WITHDRAWAL' — The type of the credit card transaction.
    - `auth_code` string — Code generated by Solaris to confirm the authorization of a settlement.
    - `terminal_id` string — (Legacy) Merchant ID for the terminal used for payment.
    - `acquirer_id` string — An identification code (up to 11 characters) of the acquiring institution.
    - `wallet_type` 'APPLE' | 'GOOGLE' | 'SAMSUNG' — Name of a digital wallet. `UNKNOWN` if the internal ID doesn't match known to Solaris. Empty string (`""`) if the transaction does not come from a wallet.
    - `device_pan` string — Reference to the device's token in that wallet
  - `created_at` string — UTC timestamp from when the reservation was created.
  - `resolved_at` string — UTC timestamp from when the reservation was resolved. If the reservation has not yet been resolved, then this property will have a value of `null`.

## Other responses

- `400` — Invalid parameters provided.
- `404` — The account could not be found.

---

[API](https://skmtc.net/solarisgroup/apis/account-management.md) · [All operations](https://skmtc.net/solarisgroup/apis/account-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/account-management/revisions/099ef636a5a1/schema)