{"uid":"cap_MMPmKZSFvdhYn0MYbI93o","slug":"agent402-receipts-settled-payment-history-ef429fc3","name":"Agent402 Receipts — Settled Payment History","description":"Your own settled calls in the shape a finance system posts: one row per payment with what was bought, the amount settled, the quoted ceiling where one applied, and the evidence - settlement transaction, sha256 of the bytes delivered, and the on-chain attestation id where one exists. Keyed to the wallet that pays for the call, so nobody can read another wallet's payables; no account, no export request, no support ticket. Requires an EIP-3009 payment (USDC on Base, Polygon, or Arbitrum).","url":"https://agent402.tools/api/receipts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","description":"ISO date or timestamp, inclusive. Default now."},"from":{"type":"string","description":"ISO date or timestamp, inclusive. Default 90 days ago."},"limit":{"type":"number","description":"Max rows per page, 1-5000 (default 500). `total` is the uncapped count for the window and `truncated` says when the page is short of it."},"format":{"type":"string","description":"\"json\" (default) or \"csv\" - the flat form a subledger imports."}}},"responseSchema":{"type":"json","example":{"to":"2026-09-11T00:00:00.000Z","from":"2026-09-01T00:00:00.000Z","note":"Every row's settlementTx is verifiable on the named chain without asking us.","rows":[{"item":"v1-chat-metered","rail":"usdc","wire":"x402","network":"solana","amountUsd":0.642466,"quotedUsd":0.74,"settledAt":"2026-09-09T10:03:05.816Z","settlementTx":"5Nk…","attestationUid":null,"responseSha256":"9f86d0…"},{"item":"hash","rail":"usdc","wire":"x402","network":"base","amountUsd":0.001,"quotedUsd":null,"settledAt":"2026-09-08T13:15:07.000Z","settlementTx":"0x6563…","attestationUid":"0x76e736…","responseSha256":"2c26b4…"}],"total":2,"wallet":"0x902dcf34e53695bdea2ffb354b1a2e58bd598256","currency":"USD","returned":2,"truncated":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kJZCtiHZaieJdXN8MeWlg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a paginated, wallet-keyed ledger of all settled x402 API payments made by the calling wallet, including item purchased, amount settled, quoted ceiling, settlement transaction, response hash, and on-chain attestation ID.","exampleAgentPrompt":"Pull my settled agent402 API receipts from September 1 to September 30, 2026 and give me the results as a CSV with up to 5000 rows so I can import them into my accounting system.","exampleUseCases":[{"title":"Monthly finance reconciliation export","prompt":"Get me a CSV of all my agent402 API payments from October 1 to October 31 with the full limit of 5000 rows — I need to reconcile them against my subledger."},{"title":"Verify a specific call was delivered","prompt":"I need to check my recent agent402 receipts from the last 7 days to find the settlement transaction hash and SHA-256 proof for the chat completion I paid for yesterday — can you pull those up in JSON format?"},{"title":"Quarterly spend audit for an AI agent fleet","prompt":"Show me all my settled agent402 API calls from July 1 through September 30, up to 5000 rows in JSON, so I can audit how much the agent fleet spent and on which items."}],"resultDescription":"A JSON or CSV document containing: the queried date window, total uncapped row count, a truncated flag, the paying wallet address, and one row per settled call with fields: item name, payment rail, wire protocol, network/chain, amount settled in USD, quoted ceiling in USD (if applicable), settlement timestamp, on-chain settlement transaction hash, optional EAS attestation UID, and SHA-256 hash of the bytes delivered.","failureModes":["Payment not provided or invalid EIP-3009 USDC payment — 402 response returned","Date range yields no rows — empty rows array with total: 0","limit out of range (must be 1–5000) — validation error","format value not 'json' or 'csv' — validation error","Wallet has no settled calls in window — returns empty result set, not an error","Network congestion or settlement delay — recently settled calls may not yet appear"],"whenToPreferThis":"Use this endpoint when an AI agent or its operator needs a verifiable, wallet-gated ledger of all past x402 API payments — particularly for finance reconciliation, expense auditing, on-chain proof retrieval, or automated subledger import. It is the only endpoint that returns per-call settlement proofs (transaction hash + SHA-256 + attestation UID) tied to a specific paying wallet without requiring an account login or support request.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:45:33.996Z","isFirstParty":false}