> ## 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.

# Supported partner corridors (African markets and international bank)

> Indicative catalog for partner checkout UI. **african_markets** — local fiat corridors (country + currency, onramp/offramp flags). **international_bank** — EUR/USD bank transfer payin; currency only, no ISO country. Binding eligibility: ``POST /partner/orders/quote``.

Indicative catalog for partner checkout UI.

### African markets (`african_markets`)

Local fiat corridors: **country**, **currency**, and **onramp** / **offramp** flags.

Optional filters: `country`, `currency`, `order_type` (`OnRamp` | `OffRamp`).

### International bank (`international_bank`)

EUR/USD bank transfer **payin** — **currency only** (do not pass ISO country).

<Note>
  Binding eligibility is confirmed at [`POST /partner/orders/quote`](/partner/orders/quote).
</Note>


## OpenAPI

````yaml /api-reference/openapi.json get /partner/corridors
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/corridors:
    get:
      tags:
        - partner
      summary: Supported partner corridors (African markets and international bank)
      description: >-
        Indicative catalog for partner checkout UI. **african_markets** — local
        fiat corridors (country + currency, onramp/offramp flags).
        **international_bank** — EUR/USD bank transfer payin; currency only, no
        ISO country. Binding eligibility: ``POST /partner/orders/quote``.
      operationId: partner_corridors_partner_corridors_get
      parameters:
        - name: country
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter African markets by ISO country.
            title: Country
          description: Filter African markets by ISO country.
        - name: currency
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by fiat currency (e.g. KES, EUR).
            title: Currency
          description: Filter by fiat currency (e.g. KES, EUR).
        - name: order_type
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: 'Filter by order type: OnRamp (buy) or OffRamp (sell).'
            examples:
              - OnRamp
              - OffRamp
            title: Order Type
          description: 'Filter by order type: OnRamp (buy) or OffRamp (sell).'
      responses:
        '200':
          description: Supported corridors (indicative)
          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 corridors (indicative)
                data:
                  african_markets:
                    - country: KE
                      currency: KES
                      onramp: true
                      offramp: true
                  international_bank:
                    currencies:
                      - currency: EUR
                        onramp: true
                        offramp: false
                      - currency: USD
                        onramp: true
                        offramp: false
              examples:
                corridors_ke:
                  summary: Filter KE
                  value:
                    status: success
                    message: Partner corridors (indicative)
                    data:
                      african_markets:
                        - country: KE
                          currency: KES
                          onramp: true
                          offramp: true
                      international_bank:
                        currencies:
                          - currency: EUR
                            onramp: true
                            offramp: false
                          - currency: USD
                            onramp: true
                            offramp: false
        '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

````