---
title: "Search for banks in a specific country (Support for international banks)."
method: GET
path: "/v0.2.4/info/bank-search"
tags: ["Info"]
---

# Search for banks in a specific country (Support for international banks).

`GET /v0.2.4/info/bank-search`

## Request

- Base URL: `https://api.chimoney.io`
- URL: `https://api.chimoney.io/v0.2.4/info/bank-search`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/chimoney/apis/chimoney-api-docs/docs/v0.2.4/info/bank-search/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `country` string, required
- `search` string, required
- `skip` integer
- `take` integer

## Response `200`

Success.

- object
  - `status` string: Status of the request.
  - `message` string: Success message.
  - `data` object[]: List of banks matching the search criteria.
    - `primaryKey` string: Unique identifier for the bank
    - `institutionName` string: Name of the banking institution
    - `address1` string: Primary address line
    - `address2` string: Secondary address line
    - `city` string: City location
    - `region` string: State or region
    - `country` string: Full country name
    - `countryISO` string: ISO country code
    - `postalCode` string: Postal/ZIP code
    - `swiftBIC` string: SWIFT/BIC code if available
    - `nationalBankCode` string: National bank identifier
    - `nationalBankCodeType` string: Type of national bank code
    - `officeType` string: Type of banking office
    - `branchName` string: Branch name if applicable
    - `phone` string: Contact phone number
    - `fax` string: Fax number
  - `pagination` object
    - `total` integer: Total number of records available
    - `skip` integer: Number of records skipped
    - `take` integer: Number of records returned

## Other responses

- `400`: Bad request - Missing or invalid parameters.
- `401`: Access to this resource is not available for unauthenticated users.
- `403`: Access to this resource is forbidden.
- `500`: Indicates an internal server error.

---

[API](https://skmtc.dev/chimoney/apis/chimoney-api-docs.md) - [All operations](https://skmtc.dev/chimoney/apis/chimoney-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/chimoney/apis/chimoney-api-docs/revisions/227751df36a0?raw)