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

# Indicative bank/network options for a rail

> Lists partner-neutral bank/network options for a rail chosen via ``GET /partner/payment-methods``. Query: ``country``, ``currency``, ``order_type`` (OnRamp or OffRamp), and ``payment_method_type``. local fiat rail rails support ``payment_method_type=bank`` (active networks only). ``payment_method_type=mobile_money`` returns 422 — use ``GET /catalog`` ``providers[].id`` for momo ``payment_method.network_id``. international bank rails (e.g. ``BankSepa``, ``BankSwift``) return best-effort enum options extracted from international bank ``FormSchema``.

Lists bank/network institution options for a rail chosen via [`GET /partner/payment-methods`](/partner/payment-methods).

### Query

`country`, `currency`, `order_type` (`OnRamp` | `OffRamp`), and `payment_method_type`.

### Rails

* **`bank`** (local fiat) — active networks only; use returned `banks[].id` as `payment_method.network_id` on quote
* **`mobile_money`** — returns **422**; use [`GET /partner/catalog`](/partner/catalog) `providers[].id` for momo `network_id`
* International bank types (e.g. `BankSepa`, `BankSwift`) — best-effort enum options from upstream form schema


## OpenAPI

````yaml /api-reference/openapi.json get /partner/banks
openapi: 3.1.0
info:
  title: Element Pay Partner API
  description: >-
    Provider-neutral fiat ↔ crypto ramps for partners. Discover corridors,
    create a binding quote, accept it, and receive webhooks. African local fiat
    (mobile money and bank) is auto-routed by corridor.
  version: 1.0.0
servers:
  - url: https://sandbox.elementpay.net/api/v1
    description: Sandbox
security:
  - APIKeyHeader: []
tags:
  - name: partner
    description: >-
      Corridor discovery, indicative rates, binding quotes, and order acceptance
      (including account currency conversion).
    x-group: Partner
  - name: partner-customers
    description: >-
      Vault KYC: requirements, create, list, get/update, documents, and submit
      (pcus_*).
    x-group: Customers
  - name: partner-customer-accounts
    description: >-
      Customer accounts and funding: open/list/get rails, deposit instructions,
      stablecoin sends, and same-currency fiat book transfers.
    x-group: Customer accounts
paths:
  /partner/banks:
    get:
      tags:
        - partner
      summary: Indicative bank/network options for a rail
      description: >-
        Lists partner-neutral bank/network options for a rail chosen via ``GET
        /partner/payment-methods``. Query: ``country``, ``currency``,
        ``order_type`` (OnRamp or OffRamp), and ``payment_method_type``. local
        fiat rail rails support ``payment_method_type=bank`` (active networks
        only). ``payment_method_type=mobile_money`` returns 422 — use ``GET
        /catalog`` ``providers[].id`` for momo ``payment_method.network_id``.
        international bank rails (e.g. ``BankSepa``, ``BankSwift``) return
        best-effort enum options extracted from international bank
        ``FormSchema``.
      operationId: partner_banks_partner_banks_get
      parameters:
        - name: country
          in: query
          required: true
          schema:
            type: string
            minLength: 2
            maxLength: 2
            description: ISO country code.
            title: Country
          description: ISO country code.
        - name: currency
          in: query
          required: true
          schema:
            type: string
            minLength: 3
            maxLength: 3
            description: Fiat currency code.
            title: Currency
          description: Fiat currency code.
        - name: order_type
          in: query
          required: true
          schema:
            type: string
            description: OnRamp or OffRamp.
            examples:
              - OffRamp
            title: Order Type
          description: OnRamp or OffRamp.
        - name: payment_method_type
          in: query
          required: true
          schema:
            type: string
            description: >-
              Rail id from ``GET /payment-methods``: rail uses ``mobile_money``
              or ``bank``; international bank uses ``PaymentMethodType`` values
              like ``BankSepa``.
            title: Payment Method Type
          description: >-
            Rail id from ``GET /payment-methods``: rail uses ``mobile_money`` or
            ``bank``; international bank uses ``PaymentMethodType`` values like
            ``BankSepa``.
      responses:
        '200':
          description: Bank institution options for bank rail
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
              example:
                status: success
                message: Partner bank/network options (indicative)
                data:
                  disclaimer: >-
                    Indicative. Binding check: POST
                    /api/v1/partner/orders/quote.
                  context:
                    country: NG
                    currency: NGN
                    order_type: OnRamp
                    payment_method_type: bank
                  supported: true
                  message: Active bank networks for this corridor.
                  banks:
                    - id: 5f1af11b-305f-4420-8fce-65ed2725a409
                      name: Access Bank
              examples:
                ng_bank_onramp:
                  summary: NG bank OnRamp banks
                  value:
                    status: success
                    message: Partner bank/network options (indicative)
                    data:
                      disclaimer: >-
                        Indicative. Binding check: POST
                        /api/v1/partner/orders/quote.
                      context:
                        country: NG
                        currency: NGN
                        order_type: OnRamp
                        payment_method_type: bank
                      supported: true
                      message: Active bank networks for this corridor.
                      banks:
                        - id: 5f1af11b-305f-4420-8fce-65ed2725a409
                          name: Access Bank
        '400':
          description: Bad request (missing corridor parameters or rail resolution failed)
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: >-
                  Provide country for African corridors (e.g. KE) or currency
                  for international bank (EUR/USD).
                data: null
        '422':
          description: Validation error (corridor not supported or invalid parameters)
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: Corridor not supported on this environment.
                data:
                  currency: EUR
                  country: FR
        '502':
          description: Upstream discovery temporarily unavailable
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
                    properties:
                      field:
                        type: string
                      country:
                        type: string
                      currency:
                        type: string
                      upstream_http_status:
                        type: integer
              example:
                status: error
                message: Quote request failed
                data:
                  upstream_http_status: 502
              examples:
                upstream_unavailable:
                  summary: Discovery upstream error
                  value:
                    status: error
                    message: Quote request failed
                    data:
                      upstream_http_status: 502
      security:
        - APIKeyHeader: []
components:
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````