Fee Breakdowns

Where to read fee details in routes, payment search, and status responses

Overview

Fee breakdowns provide itemized cost details returned by reconciliation and routing endpoints.

Use this page to understand where fee data appears and how to consume it reliably.

Where Fee Breakdowns Appear

Payment Routes

• Endpoint: GET /v2/request//routes
• Fields include:
  • fee
  • feeBreakdown[]

Route-level fee breakdowns are useful before execution (quote/comparison stage).

Payment Search

• Endpoint: GET /v2/payments
• Field includes:
  • fees[]

Payment-level fee breakdowns are useful after execution (reconciliation/reporting stage).

Request Status (when applicable)

• Endpoint: GET /v2/request/
• May include fee information in enriched status outputs.

Fee Types

Common fee type values in API responses:

• protocol
• gas
• platform
• crosschain
• crypto-to-fiat
• offramp

Route Fee Stages

For route responses, feeBreakdown can include stage-level attribution:

• sending
• receiving
• proxying
• refunding
• overall

How to Use in Reconciliation

1. Store raw fee objects

   Persist fee arrays exactly as returned (fees[] or feeBreakdown[]) before deriving reporting values.

2. Normalize by type and provider

   Group by type, provider, and currency to build accounting-friendly summaries.

3. Keep idempotent processing

   When replaying jobs or webhooks, deduplicate with stable identifiers (requestId, paymentReference, tx hash, delivery IDs).

Example Shapes

From routes endpoint

{
  "fee": 0.0021,
  "feeBreakdown": [
    {
      "type": "gas",
      "stage": "sending",
      "provider": "request-network",
      "amount": "0.0012",
      "currency": "USDC"
    },
    {
      "type": "crosschain",
      "stage": "overall",
      "provider": "lifi",
      "amount": "0.0009",
      "currency": "USDC"
    }
  ]
}

From payments endpoint

{
  "fees": [
    {
      "type": "protocol",
      "provider": "request-network",
      "amount": "0.05",
      "currency": "USDC"
    },
    {
      "type": "platform",
      "provider": "request-network",
      "amount": "0.50",
      "currency": "USDC"
    },
    {
      "type": "gas",
      "provider": "ethereum",
      "amount": "0.002",
      "currency": "ETH"
    }
  ]
}

Related Pages

Platform Fees

Configure integrator fees with feePercentage and feeAddress.

Protocol Fees

Understand protocol-level fee policy, rate, and cap.

API Reference

For complete schemas and examples, see Request Network API Reference.