World API/EVENT TRENDS

Get Events in Trend

Page through the event evidence behind one recent Event Trend bucket.

GET/api/event-trends/{id}/events

Authorizations

Bearer
Authorizationstringheader

Required Bearer API key for programmatic World access.

Example: Bearer nos_sk_...

Parameters

query & path
idstringrequiredpath

Trend result ID returned by Event Trend.

Example: tr_4a45c76c941f482e

bucketdaterequiredquery

Bucket start date returned by Event Trend.

Example: 2026-06-01

groupstringquery

Optional group value to inspect.

Example: negative

limitintegerquery

Page size, up to 200.

Example: 50

cursorstringquery

Opaque next-page cursor.

Example: AAAAAAAAADI

Related in NOSIBLE World

World · Map ↗Open this result set on the event map, filtered to the same windowWorld · Trend ↗Plot the same query as a historical event signalWorld · Chaos ↗Watch the unfiltered crawl the ontology is built from

How to use this endpoint

guidance

Use this route immediately after Event Trend to inspect evidence for a bucket or one group. The handle is short-lived; restart the trend request if it expires.

Response body

application/json

These are the fields you can build against. Nested names use dot notation; optional sections are called out in their descriptions.

totalinteger

Events retained for the selected bucket and optional group.

Example: 91

countinteger

Events returned in this page.

Example: 50

limitinteger

Applied page size.

Example: 50

eventsobject[]

Lite event records with semantic retrieval metadata.

Example: [{ event_id, event, signals, coverage, ontology, _semantic_score }]

next_cursorstring | null

Opaque next-page cursor.

Example: AAAAAAAAADI

Responses and errors

HTTP
200Request succeeded. The response body is shown in the panel on the right.
400invalid_request — The date, filter, cursor, identifier, or request combination is invalid.
401api_key_required — No API key was sent. Send it as Authorization: Bearer <key> or the api-key header.
401invalid_api_key — The API key is invalid or has been revoked.
403access_denied — The requested archive date is outside the caller's World tier.
422validation_error — A body field has the wrong type or form, such as a limit sent as a string; the message names it.
404not_found — The requested date, entity, ticker, or event does not exist in the accessible index.
410cursor_expired — The cursor was minted against a replaced index build. Restart pagination from the first page.
429rate_limited — The request exceeded the endpoint or account rate limit. Respect Retry-After when supplied.
501backend_not_configured — The World backend is not configured for this deployment.
503api_key_auth_unavailable — API key authentication is temporarily unavailable; retry shortly.
503api_key_metering_unavailable — API key usage metering is temporarily unavailable, so the request was not served; wait for the Retry-After header (30 seconds) and retry.
502backend_error — The World backend could not be reached or did not return a valid response; retry shortly.
504backend_timeout — The World backend did not answer within 300 seconds; narrow the request (for example with a date window) or retry.