> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augustus.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat the published Augustus OpenAPI specification (https://app.stainless.com/api/spec/documented/augustus/openapi.documented.yml) and the current API-reference pages as the source of truth for endpoints, request/response schemas, enum values, webhook event names, and required headers.
> Prefer the 2026-05-01 Banking API and @augustusbank/typescript-sdk for all new integrations. The 2023-01-01 API is a separate, older surface covering two products — Open Banking (instant bank transfer) checkout and refunds, and Manual Bank Transfer (MBT); use it only when one of those products is specifically required.
> Cite or link the relevant docs.augustus.com page when answering integration questions.
> Do not infer support for currencies, networks, scopes, account types, or operations that are not present in the current documentation.
> Use the sandbox base URL (https://api.sandbox.augustus.com) and placeholder credentials in examples. Never include or request a real API key.
> The Augustus docs MCP server (https://docs.augustus.com/mcp) provides documentation search and retrieval only; it does not execute authenticated Augustus API actions.

# Retrieve a Bank

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



## OpenAPI

````yaml https://app.stainless.com/api/spec/documented/getivy/openapi.documented.yml post /api/service/banks/details
openapi: 3.0.0
info:
  title: Ivy API
  description: Ivy API schema
  version: '1.0'
  contact:
    name: Ivy
    url: https://www.getivy.io
    email: help@getivy.io
servers:
  - url: https://api.getivy.de
    description: Production
  - url: https://api.sand.getivy.de
    description: Sandbox
security: []
tags: []
paths:
  /api/service/banks/details:
    post:
      tags:
        - Bank
      summary: Retrieve a Bank
      description: >-
        Retrieve a bank object by its id. The id is a unique identifier of the
        bank within Ivy.
      operationId: BanksController_details
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DetailsBanksDto'
      responses:
        '200':
          description: Returns bank details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DetailsBanksResponseDto'
      x-codeSamples:
        - lang: JavaScript
          source: |-
            import Ivy from '@getivy/node-sdk';

            const client = new Ivy();

            const bank = await client.banks.retrieve({ id: 'id' });

            console.log(bank.id);
components:
  schemas:
    DetailsBanksDto:
      type: object
      properties:
        id:
          description: The id is a unique identifier of the bank within Ivy.
          type: string
      required:
        - id
    DetailsBanksResponseDto:
      type: object
      properties:
        id:
          description: Unique identifier of the bank.
          type: string
        name:
          description: Name of the bank.
          type: string
        logo:
          description: The logo in the form of an URL
          type: string
        market:
          type: array
          items:
            type: string
            enum:
              - AF
              - AL
              - DZ
              - AS
              - AD
              - AO
              - AI
              - AQ
              - AG
              - AR
              - AM
              - AW
              - AU
              - AT
              - AZ
              - BS
              - BH
              - BD
              - BB
              - BY
              - BE
              - BZ
              - BJ
              - BM
              - BT
              - BO
              - BA
              - BW
              - BV
              - BR
              - IO
              - BN
              - BG
              - BF
              - BI
              - KH
              - CM
              - CA
              - CV
              - KY
              - CF
              - TD
              - CL
              - CN
              - CX
              - CC
              - CO
              - KM
              - CG
              - CD
              - CK
              - CR
              - CI
              - HR
              - CU
              - CY
              - CZ
              - DK
              - DJ
              - DM
              - DO
              - EC
              - EG
              - SV
              - GQ
              - ER
              - EE
              - ET
              - FK
              - FO
              - FJ
              - FI
              - FR
              - GF
              - PF
              - TF
              - GA
              - GM
              - GE
              - DE
              - GH
              - GI
              - GR
              - GL
              - GD
              - GP
              - GU
              - GT
              - GN
              - GW
              - GY
              - HT
              - HM
              - VA
              - HN
              - HK
              - HU
              - IS
              - IN
              - ID
              - IR
              - IQ
              - IE
              - IL
              - IT
              - JM
              - JP
              - JO
              - KZ
              - KE
              - KI
              - KP
              - KR
              - KW
              - KG
              - LA
              - LV
              - LB
              - LS
              - LR
              - LY
              - LI
              - LT
              - LU
              - MO
              - MG
              - MW
              - MY
              - MV
              - ML
              - MT
              - MH
              - MQ
              - MR
              - MU
              - YT
              - MX
              - FM
              - MD
              - MC
              - MN
              - MS
              - MA
              - MZ
              - MM
              - NA
              - NR
              - NP
              - NL
              - NC
              - NZ
              - NI
              - NE
              - NG
              - NU
              - NF
              - MP
              - MK
              - 'NO'
              - OM
              - PK
              - PW
              - PS
              - PA
              - PG
              - PY
              - PE
              - PH
              - PN
              - PL
              - PT
              - PR
              - QA
              - RE
              - RO
              - RU
              - RW
              - SH
              - KN
              - LC
              - PM
              - VC
              - WS
              - SM
              - ST
              - SA
              - SN
              - SC
              - SL
              - SG
              - SK
              - SI
              - SB
              - SO
              - ZA
              - GS
              - ES
              - LK
              - SD
              - SR
              - SJ
              - SZ
              - SE
              - CH
              - SY
              - TW
              - TJ
              - TZ
              - TH
              - TL
              - TG
              - TK
              - TO
              - TT
              - TN
              - TR
              - TM
              - TC
              - TV
              - UG
              - UA
              - AE
              - GB
              - US
              - UM
              - UY
              - UZ
              - VU
              - VE
              - VN
              - VG
              - VI
              - WF
              - EH
              - YE
              - ZM
              - ZW
              - AX
              - BQ
              - CW
              - GG
              - IM
              - JE
              - ME
              - BL
              - MF
              - RS
              - SX
              - SS
              - XK
        currencies:
          type: array
          items:
            type: string
            enum:
              - EUR
              - USD
              - GBP
              - PLN
              - SEK
              - DKK
            x-enumNames:
              - EUR
              - USD
              - GBP
              - PLN
              - SEK
              - DKK
        group:
          type: string
        url:
          description: The URL of the bank's website.
          type: string
        default:
          description: Whether the bank is a default bank.
          type: boolean
        test:
          description: Whether the bank is a test bank.
          type: boolean
        capabilities:
          description: The capabilities of the bank.
          type: array
          items:
            type: string
            enum:
              - ais
              - pis
            x-enumNames:
              - AIS
              - PIS
        supportedPaymentSchemes:
          description: The payment schemes supported by the bank.
          type: array
          items:
            type: string
            enum:
              - SEPA_INSTANT
              - FASTER_PAYMENTS
              - SEPA
              - ELIXIR
              - EXPRESS_ELIXIR
              - SEK_ACCOUNT_TO_ACCOUNT
              - SUMCLEARING
              - STRAKSCLEARING
              - SWIFT
              - INTERNAL
              - TARGET
              - ACH
              - FEDWIRE
            x-enumNames:
              - SEPA_INSTANT
              - FASTER_PAYMENTS
              - SEPA
              - ELIXIR
              - EXPRESS_ELIXIR
              - SEK_ACCOUNT_TO_ACCOUNT
              - SUMCLEARING
              - STRAKSCLEARING
              - SWIFT
              - INTERNAL
              - TARGET
              - ACH
              - FEDWIRE
      required:
        - id
        - name
        - market
        - currencies
        - default
        - test
        - supportedPaymentSchemes

````