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

# Get payment routes

> Get available payment routes for a request. This endpoint analyzes the payer's wallet balance across supported chains and returns possible payment methods. Routes include direct same-chain payments and crosschain bridging options when the payer has sufficient balance on different chains than the request's native chain.



## OpenAPI

````yaml /api-reference/openapi.v2.json get /v2/request/{requestId}/routes
openapi: 3.0.0
info:
  title: Request Network API
  description: API for easily creating and paying Requests with Request Network.
  version: 0.13.0
  contact: {}
servers:
  - url: https://api.request.network
    description: Production server
  - url: https://api.stage.request.network
    description: Staging server
  - url: http://127.0.0.1:8080
    description: Local development server
security: []
tags:
  - name: V2/Request
    description: Core payment request operations (V2)
  - name: V2/Payments
    description: Payment search and management operations (V2)
  - name: V2/Payouts
    description: Pay a request without creating one first (V2)
  - name: V2/Payer
    description: Crypto-to-fiat payer management operations (V2)
  - name: V2/Currencies
    description: Currency operations (V2)
  - name: V2/Client IDs
    description: Client ID management (V2)
  - name: V2/Payee Destination
    description: Payee destination management (V2)
externalDocs:
  description: Request Network Docs
  url: https://docs.request.network/request-network-api
paths:
  /v2/request/{requestId}/routes:
    get:
      tags:
        - Request
        - V2/Request
      summary: Get payment routes
      description: >-
        Get available payment routes for a request. This endpoint analyzes the
        payer's wallet balance across supported chains and returns possible
        payment methods. Routes include direct same-chain payments and
        crosschain bridging options when the payer has sufficient balance on
        different chains than the request's native chain.
      operationId: RequestControllerV2_getRequestPaymentRoutes_v2
      parameters:
        - name: requestId
          required: true
          in: path
          description: The requestId of the request
          schema:
            example: 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb
            type: string
        - name: x-api-key
          in: header
          description: API key for authentication (optional if using Client ID)
          required: false
          schema:
            type: string
        - name: x-client-id
          in: header
          description: Client ID for frontend authentication (optional if using API key)
          required: false
          schema:
            type: string
        - name: Origin
          in: header
          description: >-
            Origin header (required for Client ID auth, automatically set by
            browser)
          required: false
          schema:
            type: string
        - name: wallet
          required: true
          in: query
          description: The wallet address of the payer
          schema:
            example: '0x6923831ACf5c327260D7ac7C9DfF5b1c3cB3C7D7'
            type: string
        - name: amount
          required: false
          in: query
          description: The amount to pay, in human readable format
          schema:
            type: string
        - name: feePercentage
          required: false
          in: query
          description: Fee percentage to apply at payment time (e.g., '2.5' for 2.5%)
          schema:
            type: string
        - name: feeAddress
          required: false
          in: query
          description: Address to receive the fee
          schema:
            type: string
      responses:
        '200':
          description: Available payment routes
          content:
            application/json:
              schema:
                type: object
                description: Available payment routes for the request
                properties:
                  routes:
                    type: array
                    description: Array of available payment routes
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Unique identifier for the route
                        fee:
                          type: number
                          description: >-
                            Total fee for this route (as a decimal, e.g., 0.001
                            = 0.1%)
                        feeBreakdown:
                          type: array
                          description: Detailed breakdown of all fees for this route
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                enum:
                                  - gas
                                  - platform
                                  - crosschain
                                  - crypto-to-fiat
                                  - offramp
                                description: Type of fee
                              stage:
                                type: string
                                enum:
                                  - sending
                                  - receiving
                                  - proxying
                                  - refunding
                                  - overall
                                description: Stage when the fee is applied
                              provider:
                                type: string
                                description: Provider that charged the fee
                              amount:
                                type: string
                                description: >-
                                  Fee amount in human-readable format (formatted
                                  with token decimals)
                              amountInUSD:
                                type: string
                                description: Fee amount in USD
                              currency:
                                type: string
                                description: Fee currency
                              receiverAddress:
                                type: string
                                description: Address that received the fee
                              network:
                                type: string
                                description: Network where the fee was paid
                              rateProvider:
                                type: string
                                description: Provider used for rate conversion
                        speed:
                          oneOf:
                            - type: string
                            - type: number
                          description: >-
                            Route speed - 'FAST' for direct payments, number of
                            seconds for crosschain
                        price_impact:
                          type: number
                          description: Price impact of the route (as a decimal)
                        chain:
                          type: string
                          description: Source chain for the payment
                        token:
                          type: string
                          description: Token symbol for the payment
                      required:
                        - id
                        - fee
                        - speed
                        - chain
                        - token
                required:
                  - routes
              examples:
                requestNetworkRoute:
                  summary: Only request network route
                  value:
                    routes:
                      - id: REQUEST_NETWORK_PAYMENT
                        fee: 0
                        speed: FAST
                        price_impact: 0
                        chain: MAINNET
                        token: REQ
                sameChainRoute:
                  summary: Same-chain payment possible
                  value:
                    routes:
                      - id: REQUEST_NETWORK_PAYMENT
                        fee: 0
                        speed: FAST
                        price_impact: 0
                        chain: BASE
                        token: USDC
                      - id: BASE-BASE-USDC-USDC
                        fee: 0.001
                        speed: FAST
                        price_impact: 0
                        chain: BASE
                        token: USDC
                crosschainRoute:
                  summary: Crosschain possible
                  value:
                    routes:
                      - id: REQUEST_NETWORK_PAYMENT
                        fee: 0
                        speed: FAST
                        price_impact: 0
                        chain: BASE
                        token: USDC
                      - id: POLYGON_BASE_USDC_USDC
                        fee: 0.001
                        speed: FAST
                        price_impact: 0.999
                        chain: POLYGON
                        token: USDC
                noRoutes:
                  summary: No routes available
                  value:
                    routes: []
        '400':
          description: Invalid or missing wallet address
        '404':
          description: Request not found
        '429':
          description: Too Many Requests

````