{"lexicon":1,"id":"money.atmosphere.event.listEvents","defs":{"event":{"type":"object","required":["id","type","seq","createdAt","environment","data"],"properties":{"id":{"type":"string","maxLength":128,"description":"Delivery id (the webhook Atm-Delivery-Id)."},"type":{"type":"ref","ref":"money.atmosphere.event.defs#eventType","description":"Event type, e.g. payment.completed."},"seq":{"type":"integer","minimum":1,"description":"Globally allocated event ordering position, unique and increasing within one ledger lifetime but not contiguous within an app's event history. For pagination, use the response `cursor` rather than constructing one from seq."},"createdAt":{"type":"string","format":"datetime"},"environment":{"type":"string","knownValues":["test"],"maxLength":16,"description":"Always test. Live event history is intentionally unavailable."},"data":{"type":"unknown","description":"A bounded PII-free event summary. It retains the canonical payment.order routing, status, and state-authority cause control block for revision fencing, but excludes raw app metadata, buyer contact, shipping, and processor details."}}},"main":{"type":"query","description":"List the calling app's successfully delivered test receiver events for diagnostics. Requires app service-auth and environment=test. Live event history is unavailable. This retention-limited history is not a durable current-order reconciliation API: XRPC/webhook delivery is notification only, and canonical ATM status/current-state APIs govern fulfillment.","parameters":{"type":"params","required":["environment"],"properties":{"cursor":{"type":"string","maxLength":1024,"description":"Opaque diagnostic page cursor from a previous test response. Omit it to rescan retained delivered test events. Never use this cursor as fulfillment state."},"environment":{"type":"string","knownValues":["test"],"maxLength":16,"description":"Required environment. Only test is accepted; live returns LiveEventHistoryUnsupported."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50}}},"output":{"encoding":"application/json","schema":{"type":"object","required":["events"],"properties":{"events":{"type":"array","items":{"type":"ref","ref":"#event"}},"cursor":{"type":"string","maxLength":1024,"description":"Diagnostic cursor for the next currently delivered test row. It is not a live publication checkpoint or fulfillment authority."}}}},"errors":[{"name":"UnsupportedHistoricalCurrency"},{"name":"LiveEventHistoryUnsupported","description":"Live apps use the configured XRPC receiver or signed webhook and query canonical current state before fulfillment."}]}}}