--- title: "Search bank accounts" method: POST path: "/v0/organizations/{organization-id}/bank/accounts/search" tags: ["Bank accounts"] --- # Search bank accounts `POST /v0/organizations/{organization-id}/bank/accounts/search` ## Request - Base URL: `https://api.griffin.com` - URL: `https://api.griffin.com/v0/organizations/{organization-id}/bank/accounts/search` - Auth: API key in header `Authorization` Returns a list of bank accounts whose account number match the `search-query` supplied in the request, either exactly or partially as a prefix. ## Path parameters - `organization-id` string, required ## Request body - object - `search-query` string, required ## Response `200` OK - object - `search-results` object[], required - `account-submissions-url` union, required: Link to the [payment submissions](#tag/Payments) debiting from this account. - string - string - `bank-account-product-url` union: Link to the [bank account](#tag/Bank-accounts) product. - string - string - `account-restricted` boolean, required: Specifies whether the bank account has restrictions applied by Griffin. - `account-payments-url` union, required: Link to the [payments](#tag/Payments) associated with this account. - string - string - `pooled-account-memberships-url` union: Link to the list of [pool members](#tag/Pooled-account-membership) associated with this account. - string - string - `account-admissions-url` union, required: Link to the [payment admissions](#tag/Payments) crediting to this account. - string - string - `bank-product-type` 'savings-account' | 'client-money-account' | 'safeguarding-account' | 'embedded-account' | 'operational-account', required: Specifies the type of bank account. (For more detail on bank account types, see our guide for [types of bank accounts](/docs/guides/types-of-bank-accounts). - `account-mandates-url` union: Link to the direct debit mandates associated with this account. - string - string - `display-name` string, required: A human readable label for an entity - `controller-url` string, required: Link to the [legal person](#tag/Legal-persons) that represents the [controller](/docs/terms/controller) of the account. - `pooled-funds` boolean, required: Specifies whether the bank account holds funds belonging to multiple beneficiaries. - `accrued-interest` object, required: Shows the [accrued interest](/docs/terms/accrued-interest). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `account-status` 'closing' | 'open' | 'closed' | 'opening', required: Shows the status of the account. An account can be moved between statuses during its lifecycle. The status value affects the operations that you can perform. An account must be `"open"` to be fully operational. - `client-money-type` 'designated-client-fund' | 'designated-client-money' | 'general-client-money': Specifies the type of client money account. - `owner-url` union, required: Link to the [legal person](#tag/Legal-persons) that represents the [owner](/docs/terms/owner) of the account. - string - string - `closed-at` string, date-time: ISO 8601 formatted date-time. - `created-at` string, date-time, required: ISO 8601 formatted date-time. - `opened-at` string, date-time: ISO 8601 formatted date-time. - `close-account-url` union: Link to the endpoint that enables account closure for this account. - string - string - `available-balance` object, required: Shows the [available balance](/docs/terms/available-balance). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `pooled-account-membership-updates-url` union: Link to manage [pooled account membership](#tag/Pooled-account-membership) - string - string - `bank-account-restrictions-url` union: Link to the [restrictions](#tag/Bank-account-restrictions) on this account. - string - string - `bank-addresses` object[]: Shows a collection of public addresses which uniquely identify the account. Any one of these can be used to pay into the account. - `account-holder` string, required: The name of the [account holder](/docs/terms/account-holder). - `bank-id-code` 'gbdsc', required - `bank-id` string, required: A UK sort code. - `account-number` string, required: A UK account number. - `account-number-code` 'bban', required - `account-transactions-url` union, required: Link to the [transactions](#tag/Transactions) associated with this account. - string - string - `account-url` union, required: Link to the bank account resource. - string - string - `bank-account-events-url` union: Link to the events for this bank account. - string - string - `beneficiary-url` union: Link to the [legal person](#tag/Legal-persons) that represents the [beneficiary](/docs/terms/beneficiary) of the account. - string - string - `primary-account` boolean, required: Specifies whether the bank account is the organization's [primary account](/docs/guides/primary-account). - `account-balance` object, required: Shows the [account balance](/docs/terms/account-balance). - `currency` 'GBP', required - `value` string, required: The value as a decimal-formatted string - `savings-type` 'easy-access' | 'bare-trust': Specifies the type of savings account. - `account-statements-url` union, required: Link to the [statements](#tag/Statements) requested for this account. - string - string - `meta` object, required - `page` object - `total` integer: Total number of items. Present when the total number of items in the full result set is less than 10,000. - `estimated-total` object - `at-least` 10000: Present when the total number of items in the full result set exceeds 10,000. This indicates that the actual number of items is at least 10,000, but the exact total is not provided due to performance considerations. ## Other responses - `401`: Requires an API key to continue - `404`: Not Found ## Changes - **2026-09-19** `3e69d9e24ef6`: 1 info - api operation id `post-organizations-organization-id-bank-accounts-search` was added [Operation history](https://skmtc.dev/griffin/apis/the-griffin-api/changes/v0/organizations/:organization-id/bank/accounts/search/post.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)