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

# Get Institutions

> Returns the list of supported bank institutions for a given corridor.
 Required for corridors that use a bank selector.



## OpenAPI

````yaml /v2/openapi.yaml get /v2/institutions
openapi: 3.1.0
info:
  title: Bastion APIs
  version: '2.0'
servers:
  - url: https://api.prod.bastion.com
    description: Production environment
  - url: https://api.sandbox.bastion.io
    description: Sandbox environment
security:
  - auth: []
tags:
  - name: Bastion APIs
paths:
  /v2/institutions:
    get:
      tags:
        - Institutions
      summary: Get Institutions
      description: |-
        Returns the list of supported bank institutions for a given corridor.
         Required for corridors that use a bank selector.
      operationId: bastion.api.v2.API.ListInstitutions
      parameters:
        - name: country
          in: query
          description: ISO 3166-1 alpha-2 country code.
          required: true
          schema:
            $ref: '#/components/schemas/bastion.common.Country'
            title: country
        - name: currency
          in: query
          description: Fiat currency symbol (e.g. JPY, KRW).
          required: true
          schema:
            $ref: >-
              #/components/schemas/bastion.api.v2.payment_instructions.PaymentInstructions.FiatCurrencySymbol
            title: currency
        - name: payment_method
          in: query
          description: Payment method for the corridor.
          required: true
          schema:
            $ref: >-
              #/components/schemas/bastion.api.v2.payment_instructions.PaymentMethod
            title: payment_method
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/bastion.api.v2.institutions.ListInstitutionsResponse
        '400':
          description: Bad request
        '401':
          description: Unauthorized Request
        '500':
          description: Internal Server Error
components:
  schemas:
    bastion.common.Country:
      type: string
      title: Country
      enum:
        - US
        - CA
        - MX
        - CR
        - DO
        - GT
        - HN
        - JM
        - SV
        - AR
        - BO
        - BR
        - CL
        - CO
        - EC
        - PE
        - AT
        - BE
        - BG
        - CH
        - CY
        - CZ
        - DE
        - DK
        - EE
        - ES
        - FI
        - FR
        - GR
        - HR
        - HU
        - IE
        - IT
        - LT
        - LU
        - LV
        - MT
        - NL
        - 'NO'
        - PL
        - PT
        - RO
        - SE
        - SI
        - SK
        - AE
        - EG
        - IL
        - JO
        - QA
        - SA
        - GH
        - KE
        - ZA
        - AU
        - ID
        - IN
        - JP
        - KR
        - MY
        - PH
        - PK
        - SG
        - TH
        - GB
      description: ISO 3166-1 alpha-2 country code.
      example: US
    bastion.api.v2.payment_instructions.PaymentInstructions.FiatCurrencySymbol:
      type: string
      title: FiatCurrencySymbol
      enum:
        - USD
        - MXN
        - INR
        - KRW
        - JPY
        - SGD
        - MYR
        - THB
        - IDR
        - PHP
        - QAR
        - EGP
        - JOD
        - GHS
        - KES
        - HNL
        - BOB
        - JMD
        - COP
        - GTQ
        - BRL
        - PEN
        - CLP
        - CRC
        - DOP
        - ZAR
        - CAD
        - PKR
        - SAR
        - ILS
        - EUR
        - GBP
        - ARS
        - AUD
        - AED
      description: Fiat currency symbol.
      example: USD
    bastion.api.v2.payment_instructions.PaymentMethod:
      type: string
      title: PaymentMethod
      enum:
        - WIRE
        - ACH
        - SPEI
        - IMPS_FIRC
        - BANK_TRANSFER
        - CCE
        - TEF
        - SINPE
        - LBTR
        - EFT
        - IBFT
        - MADA
        - ZAHAV
        - SEPA
        - PIX
        - COELSA
        - BECS
        - NPSS
      description: Payment method for the fiat transaction.
      example: WIRE
    bastion.api.v2.institutions.ListInstitutionsResponse:
      type: object
      properties:
        country:
          $ref: '#/components/schemas/bastion.common.Country'
          title: country
          description: Country echoed back from the request.
        currency:
          $ref: >-
            #/components/schemas/bastion.api.v2.payment_instructions.PaymentInstructions.FiatCurrencySymbol
          title: currency
          description: Currency echoed back from the request.
        payment_method:
          $ref: >-
            #/components/schemas/bastion.api.v2.payment_instructions.PaymentMethod
          title: payment_method
          description: Payment method echoed back from the request.
        all_institutions_supported:
          type: boolean
          title: all_institutions_supported
          description: When true, any bank is accepted and institutions is empty.
        institutions:
          type: array
          items:
            $ref: '#/components/schemas/bastion.api.v2.institutions.Institution'
          title: institutions
          description: >-
            List of supported institutions. Empty when
            all_institutions_supported is true.
      title: ListInstitutionsResponse
      additionalProperties: false
      description: Response containing supported institutions for a corridor.
    bastion.api.v2.institutions.Institution:
      type: object
      properties:
        bank_id:
          type: string
          title: bank_id
          description: >-
            Opaque bank identifier. Pass this as bank_id when registering
            payment instructions.
          readOnly: true
        name:
          type: string
          title: name
          description: Human-readable institution name.
          readOnly: true
      title: Institution
      additionalProperties: false
      description: Institution represents a single bank available for a corridor.
  securitySchemes:
    auth:
      type: http
      description: Bearer authentication with an API token
      scheme: bearer

````

## Related topics

- [Off-ramp payout countries and required fields](/v2/api-reference/conversions/off-ramp-payout-countries-and-required-fields.md)
- [Off-ramp: Withdraw stablecoin internationally](/guides/quickstarts/off-ramp/international-bank-account.md)
- [Bastion platform overview](/guides/getting-started/bastion-platform-overview.md)
- [Get Bank Account](/v2/api-reference/issuance/get-bank-account.md)
- [Get Mint Instructions](/v2/api-reference/issuance/get-mint-instructions.md)