Skip to main content
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

Requires X-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 notifications
number
default:"50"
Maximum number of notifications to return (max: 100)

Response

array
Array of notification objects
number
Number of notifications returned

Example Request

Example Response

SDK Usage

Notification Types