Fetch a payment receipt by id

Returns the client-facing receipt for a paid request: payer wallet, payment scheme, transaction reference, and the amounts actually charged (atomic USDC integers are canonical; decimal strings are derived). The unguessable UUIDv4 receipt id — issued in the X-Solvela-Receipt response header on paid responses — is the only credential: treat it as a bearer capability. Unknown and malformed ids both return the same 404, and there is no listing endpoint. Free ($0) requests produce no payment and therefore no receipt.

get/v1/receipts/{receipt_id}

Request

  • Base URL: https://api.solvela.ai
  • URL: https://api.solvela.ai/v1/receipts/{receipt_id}
  • Auth: none required

Path parameters

receipt_idstring uuid required

UUIDv4 receipt id from the X-Solvela-Receipt header.

Response

The receipt.

receipt_idstring uuid required
created_atstring date-time required

When the receipt was recorded (request completion time, UTC).

modelstring required

Model ID (chat path) or marketplace service ID (services proxy path).

payment_schemestring required

x402 scheme that settled the payment.

tx_signaturestring

Payment transaction reference as recorded on the spend ledger (the signed transaction carried in the payment payload). Absent when no reference was extractable.

payer_walletstring required

Payer wallet (base58 pubkey) extracted from the signed payment.

amount_paid_atomicinteger required

Amount actually billed, atomic USDC. Canonical.

amount_paid_usdcstring required

Example response

{
  "model": "openai/gpt-4o",
  "payment_scheme": "exact",
  "amount_paid_usdc": "0.002625",
  "cost_breakdown": {
    "provider_cost_usdc": "0.002500",
    "platform_fee_usdc": "0.000125",
    "total_usdc": "0.002625",
    "currency": "USDC"
  },
  "vendor": {
    "settled_usdc": "0.020000",
    "fee_receivable_usdc": "0.001000"
  }
}

Changes

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