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

# GET /v0/bank/holds/{hold-id}

`GET /v0/bank/holds/{hold-id}`

## Request

- Base URL: `https://api.griffin.com`
- URL: `https://api.griffin.com/v0/bank/holds/{hold-id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/griffin/apis/the-griffin-api/docs/v0/bank/holds/:hold-id/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches a single hold by ID.

## Path parameters

- `hold-id` string, required

## Response `200`

OK

- object: A hold on a bank account.
  - `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.

## 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-holds-hold-id` was added

[Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/bank/holds/:hold-id/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)