List the events received for an account
Returns events received for this account in the last 24 hours, newest first, same payload a webhook would get. Retention is 24h from received_at, absolute; claiming doesn't extend it. Order is arrival, not causal. Claims nothing; safe to poll. Page until cursor is null.
Request
- Base URL: https://api.curviate.com
- URL: https://api.curviate.com/v1/{account_id}/events
- Auth: HTTP bearer
Path parameters
The connected LinkedIn account whose received events to read.
Query parameters
Pagination cursor from a previous response; decodable, pass it back verbatim
Return only events in this state: unread (includes an expired lease), claimed, or done. Omit for every state. There is no failed state.
How many events to return per page, 1 to 100. Defaults to 50.
Response
The events Curviate received for this account in the last 24 hours, newest received first. Events are retained whether or not any webhook is subscribed to them, which is what makes this readable with no listener running. Retention is 24 hours from received_at, absolute: an event is deleted on that clock and nothing extends it, including a live claim. Disconnecting an account removes its events from this response immediately. Each item carries its queue state, so state=done answers what your agents have already handled and state=unread answers what is still waiting. This read never claims anything.
Example response
{
"safety_warning": {
"row": "profile_views",
"reset_at": "2026-09-05T00:00:00.000Z",
"hint": {
"parameter": "profile_views.ceiling",
"message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
},
"reason": "ceiling",
"blocked": false
}
}Changes
No recorded changes to this operation across all 1 revision of this API.