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

# List supported routes

> Searches supported partner routes by category, country, optional subdivision, source currency, destination currency, and payment method or payment type. When both `paymentMethod` and `paymentType` are provided, `paymentMethod` takes precedence. Provider scope rules:
- No Basic Auth and no `Meld-Account-Id`: results come from the global dataset.
- Basic Auth only: results are restricted to the authenticated identity's `providers` claim.
- `Meld-Account-Id` only: results are restricted to providers configured for that account.
- Both Basic Auth and `Meld-Account-Id`: results are restricted to the intersection of both provider sets.
- Explicit partner filters are intersected with the resolved provider scope.

Explicit `partners` filtering is intersected with the resolved provider scope.
If the effective provider scope contains no providers, this collection endpoint returns `200` with an empty result.



## OpenAPI

````yaml /openapi/networkpartner-20260203.json get /network-partner/supported/routes/{category}/{countryCode}/{sourceCurrencyCode}/{destinationCurrencyCode}
openapi: 3.1.0
info:
  title: Network Partners
  version: '2026-02-03'
servers:
  - url: https://api.meld.io
security: []
paths:
  /network-partner/supported/routes/{category}/{countryCode}/{sourceCurrencyCode}/{destinationCurrencyCode}:
    get:
      tags:
        - Supported
      summary: List supported routes
      description: >-
        Searches supported partner routes by category, country, optional
        subdivision, source currency, destination currency, and payment method
        or payment type. When both `paymentMethod` and `paymentType` are
        provided, `paymentMethod` takes precedence. Provider scope rules:

        - No Basic Auth and no `Meld-Account-Id`: results come from the global
        dataset.

        - Basic Auth only: results are restricted to the authenticated
        identity's `providers` claim.

        - `Meld-Account-Id` only: results are restricted to providers configured
        for that account.

        - Both Basic Auth and `Meld-Account-Id`: results are restricted to the
        intersection of both provider sets.

        - Explicit partner filters are intersected with the resolved provider
        scope.


        Explicit `partners` filtering is intersected with the resolved provider
        scope.

        If the effective provider scope contains no providers, this collection
        endpoint returns `200` with an empty result.
      operationId: find-supported-routes
      parameters:
        - description: Provider category
          example: CRYPTO_ONRAMP
          name: category
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/Category'
        - description: Country code
          example: US
          name: countryCode
          in: path
          required: true
          schema:
            type: string
        - description: Destination currency code
          example: BTC
          name: destinationCurrencyCode
          in: path
          required: true
          schema:
            type: string
        - description: Source currency code
          example: USD
          name: sourceCurrencyCode
          in: path
          required: true
          schema:
            type: string
        - description: Comma-separated partner ids
          example: PAYBIS,BANXA
          name: partners
          in: query
          schema:
            type: string
        - description: Canonical payment method code
          example: CREDIT_DEBIT_CARD
          name: paymentMethod
          in: query
          schema:
            type: string
        - description: Payment method type
          example: CARD
          name: paymentType
          in: query
          schema:
            $ref: '#/components/schemas/PaymentType'
        - description: >-
            Country subdivision code. Supported for US and CA only. Use either
            full ISO 3166-2 code or local code.
          example: US-NY
          name: subdivision
          in: query
          schema:
            type: string
        - description: >-
            Optional. Base58 encoded account id. Restricts results to providers
            configured for the account. If Basic Auth is also present, the
            effective scope is the intersection of authenticated providers and
            account providers.
          name: Meld-Account-Id
          in: header
          schema:
            type: string
      responses:
        '200':
          description: Supported routes
          content:
            application/json:
              examples:
                supportedRoutes:
                  summary: Matching supported routes
                  value:
                    - partner: BANXA
                      source: USD
                      destination: BTC
                      paymentMethods:
                        - paymentType: CARD
                          name: CREDIT_DEBIT_CARD
                          partnerMethodName: card
                          limits:
                            currencyCode: USD
                            min: 10
                            max: 10000
                          logo:
                            dark: >-
                              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_dark.png
                            light: >-
                              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_light.png
                      kycLimits:
                        - provider: BANXA
                          category: CRYPTO_ONRAMP
                          countryCode: US
                          limitType: DAILY
                          currencyCode: USD
                          level1: 1000
                          level2: 10000
                          level3: 50000
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/SupportedRoute'
components:
  schemas:
    Category:
      type: string
      enum:
        - CRYPTO_ONRAMP
        - CRYPTO_OFFRAMP
        - CRYPTO_TRANSFER
        - BANK_LINKING
        - FIAT_PAYMENTS
        - CRYPTO_VIRTUAL_ACCOUNT_ONRAMP
        - CRYPTO_VIRTUAL_ACCOUNT_OFFRAMP
        - CUSTOMER_KYC
        - CRYPTO_ONRAMP_SWAP
        - CRYPTO_OFFRAMP_SWAP
      description: Categories of functionality offered by a service provider
    PaymentType:
      type: string
      enum:
        - BANK_TRANSFER
        - CARD
        - CASH
        - EXCHANGE
        - LOCAL
        - MOBILE_WALLET
      description: Enumeration of payment method types supported by the platform
    SupportedRoute:
      type: object
      description: >-
        Supported route details for a specific source and destination currency
        pair
      properties:
        partner:
          type: string
          examples:
            - BANXA
          description: Partner identifier
        source:
          type: string
          examples:
            - USD
          description: Source currency code
        destination:
          type: string
          examples:
            - BTC
          description: Destination currency code
        paymentMethods:
          type: array
          items:
            $ref: '#/components/schemas/PaymentMethod2'
          description: >-
            Payment methods for the route. Empty for swap routes without payment
            methods.
        kycLimits:
          type: array
          items:
            $ref: '#/components/schemas/ProviderKycLimit'
          description: >-
            Provider KYC limits for this route. Empty when limits are not
            available.
    PaymentMethod2:
      type: object
      description: Payment method details for a supported route
      properties:
        paymentType:
          type: string
          examples:
            - CARD
          description: Payment type
          allOf:
            - $ref: '#/components/schemas/PaymentType'
        name:
          type: string
          examples:
            - CREDIT_DEBIT_CARD
          description: Canonical payment method code
        partnerMethodName:
          type: string
          examples:
            - card
          description: Partner-specific payment method identifier
        limits:
          type: object
          description: Limits for this payment method. Null when limits are not available.
          allOf:
            - $ref: '#/components/schemas/Limit'
        logo:
          type: object
          description: Payment method logo variants
          allOf:
            - $ref: '#/components/schemas/PaymentMethodLogo'
        headlessSupported:
          type: boolean
          description: Whether this provider payment method is enabled for headless flows
        cardRenderMode:
          type: string
          description: >-
            Card render mode; only populated for CREDIT_DEBIT_CARD when
            headlessSupported
          allOf:
            - $ref: '#/components/schemas/CardRenderMode'
    ProviderKycLimit:
      type: object
      description: Provider KYC limits for a currency and limit window
      properties:
        provider:
          type: string
          examples:
            - BANXA
          description: Provider identifier
        category:
          type: string
          examples:
            - CRYPTO_ONRAMP
          description: Provider category
          allOf:
            - $ref: '#/components/schemas/Category'
        countryCode:
          type: string
          examples:
            - US
          description: Country code
        limitType:
          type: string
          examples:
            - DAILY
          description: Limit window
          allOf:
            - $ref: '#/components/schemas/LimitType'
        currencyCode:
          type: string
          examples:
            - USD
          description: Currency code
        level1:
          type: number
          examples:
            - 1000
          description: KYC level 1 amount
        level2:
          type: number
          examples:
            - 10000
          description: KYC level 2 amount
        level3:
          type: number
          examples:
            - 50000
          description: KYC level 3 amount
    Limit:
      type: object
      description: Limits for a supported route
      properties:
        currencyCode:
          type: string
          examples:
            - USD
          description: Currency code
        min:
          type: number
          examples:
            - 10
          description: Minimum amount
        max:
          type: number
          examples:
            - 10000
          description: Maximum amount
    PaymentMethodLogo:
      type: object
      description: Payment method logo variants
      properties:
        dark:
          type: string
          examples:
            - >-
              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_dark.png
          description: Dark logo URL
        light:
          type: string
          examples:
            - >-
              https://cdn.meld.io/images-paymentmethod/CREDIT_DEBIT_CARD/logo_light.png
          description: Light logo URL
    CardRenderMode:
      type: string
      enum:
        - IFRAME
        - REDIRECT
      description: Render mode for CREDIT_DEBIT_CARD payment method in headless flows
    LimitType:
      type: string
      enum:
        - TRANSACTION
        - DAILY
        - WEEKLY
        - MONTHLY
        - YEARLY
      description: Limit windows applied to transaction limits

````