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

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.  This endpoint replaces the old version. However, please note that you have to set the  header to the version you want (e.g., ). If you do not specify a version, then the API will return the older version of the response.

Endpoint: GET /v1/accounts/{account_id}/reservations
Version: 1.0

## Path parameters:

  - `account_id` (string, required)
    Unique identifier of a customer's account.
    Example: "e48c29b85992b8772eb7ddd518490920cacc"

## Query parameters:

  - `page[number]` (string)
    Returns a specific page of results.

  - `page[size]` (string)
    Determines the size of each page of results.

  - `filter[type]` (string)
    Filters the returned reservations by type.
    Enum: "CardAuthorization", "SepaCreditTransfer", "ClearingTransaction", "IntraCustomerTransfer", "SepaCreditBatch", "Seizure", "SecuritiesPurchase", "PendingTrade", "SEPAInstantCreditTransfer"

  - `filter[id]` (string)
    Filters the returned reservations by ID.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

  - `filter[status]` (string)
    Filters the reservations by status, e.g., OPEN.
    Enum: "OPEN", "RESOLVED"

  - `sort` (string)
    Sorts the returned reservations by created_at date.
    Enum: "created_at", "-created_at"

## Response 200 fields (application/json):

  - `id` (string)
    ID of the reservation.
    Example: "162ddd7e-790c-5963-908f-4cedfd30f9a1"

  - `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.
    Example: "e48c29b85992b8772eb7ddd518490920cacc"

  - `iban` (string)
    IBAN of the account to which the reservation is attached.
    Example: "DE84110101010001234567"

  - `amount` (object)
    The amount of the reservation, in Euro cents.

  - `amount.value` (integer)
    Example: 800

  - `amount.unit` (string)
    Example: "cents"

  - `amount.currency` (string)
    Example: "EUR"

  - `type` (string)
    Enum: "CardAuthorization", "SepaCreditTransfer", "ClearingTransaction", "IntraCustomerTransfer", "SepaCreditBatch", "Seizure", "SecuritiesPurchase", "PendingTrade", "SEPAInstantCreditTransfer"

  - `reference` (string)
    Internal reference number for the reservation.
    Example: "85f20dc2-190f-47d3-94c7-2737ca71f286"

  - `status` (string)
    The current status of the reservation. Possible values are  and .
    Enum: "OPEN", "RESOLVED"

  - `meta_info` (any)

  - `created_at` (string)
    UTC timestamp from when the reservation was created.
    Example: "2022-06-20T18:49:49Z"

  - `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 .
    Example: "null"

## Response 400 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "400"

  - `code` (string)
    Example: "build_pagination_headers_failure"

  - `title` (string)
    Example: "Failed to build pagination headers."

  - `detail` (string)
    Example: "Cannot connect to database."

## Response 404 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "404"

  - `code` (string)
    Example: "model_not_found"

  - `title` (string)
    Example: "Model Not Found"

  - `detail` (string)
    Example: "Couldn't find 'Account' for id 'DE24112233445566'."