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

# List bank account restrictions

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

Lists restrictions on a bank account.

Returns all restrictions (both `active` and `lifted`) by default. Use
`filter[restriction-status][eq]=active` to return only active restrictions.

See [get restriction](#tag/Bank-account-restrictions/paths/~1v0~1bank~1account-restrictions~1%7Bbank-account-restriction-id%7D/get)
for details on field visibility and redaction.

## Path parameters

- `bank-account-id` string, required

## Query parameters

- `filter[restriction-status][eq]` 'lifted' | 'active'
- `sort` '-created-at' | 'created-at'
- `page[size]` integer
- `page[after]` string, byte
- `page[before]` string, byte

## Response `200`

OK

- object — A list of bank account restrictions.
  - `bank-account-restrictions` object[], required
    - `lift-bank-account-restriction-url` union — Link to lift a bank account restriction.
      - string
      - string
    - `restriction-status` union, required
      - 'lifted' | 'active'
      - string
    - `restriction-legal-status` union
      - 'not-applicable' | 'conviction-confirmed' | 'formal-charge-filed' | 'suspected'
      - string
    - `bank-account-restriction-url` union, required — Link to a bank account restriction.
      - string
      - string
    - `created-at` string, date-time, required — ISO 8601 formatted date-time.
    - `update-bank-account-restriction-url` union — Link to update a bank account restriction.
      - string
      - string
    - `bank-account-restriction-events-url` union, required — Link to events for a bank account restriction.
      - string
      - string
    - `restriction-reason-code` union
      - 'suspicious' | 'fraud-app-perpetrator' | 'customer-request' | 'dormant' | 'other' | 'terrorist-financing' | 'law-enforcement' | 'sanctions' | 'risk-appetite' | 'deceased' | 'fraud-app-victim' | 'fraud-3rd-party' | 'money-laundering' | 'fraud' | 'high-risk-pep' | 'fraud-1st-party'
      - string
    - `restriction-type` union
      - 'block' | 'freeze'
      - string
    - `account-url` union, required — Link to the bank account resource.
      - string
      - string
    - `restriction-applied-by` union, required
      - object
        - `restriction-applied-by-type` 'ops-user', required
      - object
        - `restriction-applied-by-type` 'user', required
        - `user-url` string, required — Link to the user.
        - `user-username` string — The username.
  - `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)