Router

List / export the buyer’s unified payment record across all agents

Returns your Router payments (newest first, capped at 1000) across every agent and delegation — the unified audit trail. Filter by delegationId and by from/to (ISO-8601, inclusive on createdAt). format=csv returns a CSV file download instead of the JSON array.

Supplying requestId selects a separate, exact, caller-scoped lookup instead: the list filters are ignored and it is not subject to the 1000-row window. JSON answers it with an explicit presence discriminator and zero or one payments; a failed lookup is an error, never absent. With format=csv it answers the matching row, or only the header when there is none. An older Router that ignores requestId answers a plain array, which is never authoritative absence.

get/router/payments

Request

  • Base URL: https://api.sandbox.nevermined.app/api/v1
  • URL: https://api.sandbox.nevermined.app/api/v1/router/payments
  • Auth: HTTP bearer

Query parameters

delegationIdstring

Only payments spent against this delegation id. Ignored with requestId.

fromstring
Example:2026-07-01T00:00:00Z

ISO-8601 lower bound on createdAt (inclusive). Ignored with requestId.

tostring
Example:2026-07-31T23:59:59Z

ISO-8601 upper bound on createdAt (inclusive). Ignored with requestId.

requestIdstring
Example:order-1234

Exact, caller-scoped idempotency key: look up the one payment made with it. Matched exactly as you sent it, padding included. Percent-encode it (an unencoded + reads as a space). Selects the lookup envelope (RouterPaymentLookupDto); the other list filters are ignored.

format'json' | 'csv'

Response format. Defaults to JSON; csv returns a downloadable file.

Response

A JSON array for a list; the lookup envelope (RouterPaymentLookupDto) with requestId; or a CSV file when format=csv.

OR

Example response

[
  {
    "id": "b1f9c2e4-3d5a-4c7e-9f21-6a8b0c4d2e13",
    "createdAt": "2026-07-01T09:00:55.605Z",
    "status": "Settled",
    "protocol": "x402",
    "network": "base-sepolia",
    "asset": "USDC",
    "assetSymbol": "USDC.e",
    "assetDecimals": 6,
    "amount": "1000",
    "merchantAddress": "0x209693Bc6afc0C5328bA36FaF03C514EF312287C",
    "txHash": "0xfc8af37b...",
    "delegationId": "5e7481c3-...",
    "deliveryStatus": "delivered",
    "feeFailureReason": "HTTP 400: {\"errorReason\":\"amount_too_low\",\"network\":\"eip155:84532\",\"success\":false}",
    "merchantSettlementObservedAt": "2026-09-08T10:12:00.000Z",
    "paymentId": "b1f9c2e4-8a3d-4f27-9c6b-5d2e17a04f8b",
    "chargedMicros": "1020000",
    "resultUrl": "/api/v1/router/payments/b1f9c2e4-8a3d-4f27-9c6b-5d2e17a04f8b/result",
    "fundingSource": "delegation",
    "resourceUrl": "https://agent.example/resource",
    "buyer": "0x8D6A5233...",
    "feeAtomic": "0",
    "feeCents": "0",
    "feeStatus": "None",
    "feeTxHash": "0x9c4d6f1e...",
    "feeNonce": "0x7b1e2c..."
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.