---
title: "Retrieve a Bank"
method: POST
path: "/api/service/banks/details"
tags: ["Bank"]
---

# Retrieve a Bank

`POST /api/service/banks/details`

Retrieve a bank object by its id. The id is a unique identifier of the bank within Ivy.

## Request body

- DetailsBanksDto
  - `id` string, required — The id is a unique identifier of the bank within Ivy.

## Response `200`

Returns bank details

- DetailsBanksResponseDto
  - `id` string, required — Unique identifier of the bank.
  - `name` string, required — Name of the bank.
  - `logo` string — The logo in the form of an URL
  - `market` string[], required
  - `currencies` string[], required
  - `group` string
  - `url` string — The URL of the bank's website.
  - `default` boolean, required — Whether the bank is a default bank.
  - `test` boolean, required — Whether the bank is a test bank.
  - `capabilities` string[] — The capabilities of the bank.
  - `supportedPaymentSchemes` string[], required — The payment schemes supported by the bank.

## Changes

- **2026-05-28** `985fef88525b` — 2 warning
  - added the new `ACH` enum value to the `supportedPaymentSchemes/items/` response property for the response status `200`
  - added the new `FEDWIRE` enum value to the `supportedPaymentSchemes/items/` response property for the response status `200`
- **2026-04-29** `84194dfc43b4` — 1 warning
  - added the new `USD` enum value to the `currencies/items/` response property for the response status `200`

[Change history](https://skmtc.dev/augustus/apis/ivy-api/changes/api/service/banks/details/post.md)

---

[API](https://skmtc.dev/augustus/apis/ivy-api.md) · [All operations](https://skmtc.dev/augustus/apis/ivy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/augustus/ivy-api/revisions/c3055fc06ca3/schema)