---
title: "Search banks by name"
method: GET
path: "/v1/banks"
tags: ["Entities"]
---

# Search banks by name

`GET /v1/banks`

## Request

- Base URL: `https://api.triqai.com`
- URL: `https://api.triqai.com/v1/banks`
- Auth: API key in header `X-API-Key`

Search stored banks by exact, case-insensitive name (surrounding whitespace is ignored).
Optionally filter by ISO country of origin, not a country where the bank operates.
Requires an API key, is rate limited, and costs zero credits. No enrichment or creation occurs.
Returns all matching candidates in pages ordered by country (unknown last), then ID.
No match returns an empty array. Results are read directly from the database so backfilled
details are available immediately. Pagination is not a snapshot across requests.

## Query parameters

- `name` string, required
- `country` string
- `page` integer
- `size` integer

## Response `200`

Matching bank candidates (possibly empty)

- BankSearchResponse
  - `success` true, required
  - `data` object, required
    - `banks` BankData[], required
      - `id` string, uuid, required
      - `name` string, required
      - `country` string, nullable, required: ISO 3166-1 alpha-2 country of origin, not countries of operation.
      - `foundedYear` integer, nullable, required: Founding year when known. May be populated without an exact date.
      - `foundedOn` string, date, nullable, required: Exact founding date when known (YYYY-MM-DD). Never inferred from the year alone.
      - `description` string, nullable, required
      - `icon` string, nullable, required: Bank logo URL, consistent with merchant icon fields.
      - `color` string, nullable, required: Brand color.
      - `website` string, nullable, required
      - `domain` string, nullable, required
    - `pagination` object, required
      - `page` integer, required
      - `size` integer, required
      - `hasMore` boolean, required: More candidates exist; request the next page with the same filters and size.
  - `meta` ResponseMeta, required
    - `generatedAt` string, date-time, required
    - `requestId` string, required
    - `version` string, required

## Other responses

- `401`: Authentication failed or missing credentials
- `403`: Authenticated but not authorized
- `422`: Request validation failed
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api.md) - [All operations](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triqai/apis/triqai-transaction-enrichment-api/revisions/da1b24723e53?raw)