---
title: "GET /v0/bank/accounts/{bank-account-id}/holds"
method: GET
path: "/v0/bank/accounts/{bank-account-id}/holds"
tags: ["Bank account holds"]
---

# GET /v0/bank/accounts/{bank-account-id}/holds

`GET /v0/bank/accounts/{bank-account-id}/holds`

Lists all holds on a bank account.
                 Use `filter[status][in][]` to filter by specific statuses.
                 Use `filter[updated-at][gte]` to return only holds last updated at or after a timestamp.
                 Use `filter[origin-type][eq]` to filter by origin type.

## Path parameters

- `bank-account-id` string, required

## Query parameters

- `filter[origin-type][eq]` 'card-transaction'
- `filter[updated-at][gte]` string, date-time
- `filter[status][in][]` string[]
- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object — All holds which have ever been placed on the bank account.
  - `holds` object[], required
    - `expires-at` string, date-time — ISO 8601 formatted date-time.
    - `origin-type` 'card-transaction', required
    - `updated-at` string, date-time, required — ISO 8601 formatted date-time.
    - `origin-metadata` object — Identifiers from the system that originated the hold or transaction. Keys and values are originator-specific.
    - `direction` 'debit' | 'credit', required
    - `status` 'released' | 'placed', required
    - `created-at` string, date-time, required — ISO 8601 formatted date-time.
    - `release-reason` string — The final release reason (e.g. clearing, expiry, reversal
    - `amount` object, required
      - `currency` 'GBP', required
      - `value` string, required — The value as a decimal-formatted string
    - `account-url` union, required — Link to the bank account resource.
      - string
      - string
    - `hold-url` union, required — Link to this hold.
      - string
      - string
    - `account-transactions` object[] — All account transactions associated with this hold.
      - `account-transaction-url` union, required — Link to the transaction resource.
        - string
        - string
      - `updated-hold-at` string, date-time, required — When this account transaction updated the hold.
  - `links` object, required
    - `prev` string, nullable, required
    - `next` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Requires an API key to continue
- `404` — Not Found

---

[API](https://skmtc.net/griffin/apis/the-griffin-api.md) · [All operations](https://skmtc.net/griffin/apis/the-griffin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griffin/the-griffin-api/revisions/178ed43d543b/schema)