---
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`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/bank/accounts/{bank-account-id}/holds`
- Auth: API key in header `Authorization`

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

## Changes

- **2026-09-19** `3e69d9e24ef6`: 1 info
  - api operation id `get-bank-accounts-bank-account-id-holds` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/bank/accounts/:bank-account-id/holds/get.md)

---

[API](https://skmtc.dev/griffin/apis/the-griffin-api.md) - [All operations](https://skmtc.dev/griffin/apis/the-griffin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/griffin/apis/the-griffin-api/revisions/9e4c303c70a5?raw)