Skip to main content
GET
/
v1
/
analytics
/
receipts
curl "https://win.oneshotagent.com/v1/analytics/receipts?period=7&category=communication" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "receipts": [
    {
      "receipt_id": "rcpt_01HGW2HB4V4T0PZGJ8PFDRCHQM",
      "category": "communication",
      "subcategory": "email",
      "amount_usdc": "0.150000",
      "service_fee": "0.030000",
      "provider_cost": "0.120000",
      "status": "settled",
      "settlement_tx": "0x1a2b3c...",
      "memo": "Following up on demo request from yesterday's webinar",
      "decisionContext": {
        "goal": "Convert webinar leads to discovery calls",
        "confidence": 0.78,
        "campaign": "webinar-q2"
      },
      "value_tag": null,
      "created_at": "2026-03-09T14:30:00Z",
      "settled_at": "2026-03-09T14:30:01Z"
    }
  ],
  "count": 1,
  "has_more": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns a paginated list of receipts for the calling agent. Free endpoint — requires X-Agent-ID only.

​
Query Parameters

​
period
number
default:"all"
Filter to last N days (1–365). Omit to include all receipts.
​
category
string
Filter by category: data, verification, communication, commerce, infrastructure, agent_to_agent. See overview for the tool→category mapping.
​
limit
number
default:"50"
Results per page (1–100)
​
offset
number
default:"0"
Pagination offset
curl "https://win.oneshotagent.com/v1/analytics/receipts?period=7&category=communication" \
  -H "X-Agent-ID: 0xYourWalletAddress"

{
  "receipts": [
    {
      "receipt_id": "rcpt_01HGW2HB4V4T0PZGJ8PFDRCHQM",
      "category": "communication",
      "subcategory": "email",
      "amount_usdc": "0.150000",
      "service_fee": "0.030000",
      "provider_cost": "0.120000",
      "status": "settled",
      "settlement_tx": "0x1a2b3c...",
      "memo": "Following up on demo request from yesterday's webinar",
      "decisionContext": {
        "goal": "Convert webinar leads to discovery calls",
        "confidence": 0.78,
        "campaign": "webinar-q2"
      },
      "value_tag": null,
      "created_at": "2026-03-09T14:30:00Z",
      "settled_at": "2026-03-09T14:30:01Z"
    }
  ],
  "count": 1,
  "has_more": false
}

​
Audit fields

Receipts include the audit metadata the caller attached at call time:
​
memo
string | null
Human-readable reason for the tool call, up to 1000 chars. Set via the SDK’s memo option or memo in the JSON body. See Audit Trail.
​
decisionContext
object | null
Machine-readable decision metadata. Open schema; known fields include goal, goalId, alternatives, confidence (0-1). Used by supervisor / auditor agents.
A non-null value_tag only counts toward RoCS when its status is "confirmed". See Tag Receipt Value for how to tag.