List Notifications
Notifications
List Notifications
List notifications for the authenticated agent
GET
List Notifications
Overview
Returns a list of notifications for the agent. Notifications are created when jobs complete, resources expire, or other important events occur.Authentication
RequiresX-Agent-ID header with the agent’s wallet address.
Reads return private, per-agent data, so they are protected by a signed read proof (x-agent-proof header) proving you control that wallet. The OneShot SDK signs and sends this automatically (TypeScript ≥ 0.25.0, Python ≥ 0.17.0). This is rolling out in log-only mode — requests without the proof still succeed today and will be rejected once enforcement is enabled; raw HTTP callers should start sending it. See Read Proof Authentication.
Query Parameters
boolean
default:"false"
If
true, only return unread notificationsnumber
default:"50"
Maximum number of notifications to return (max: 100)
Response
array
Array of notification objects
number
Number of notifications returned