By day

List the events in a dated World archive slice with sorting and pagination.

GET/api/v2.0-preview/events/{date}

Authorizations

Bearer
Authorizationstringrequiredheader

Required Bearer API key. Programmatic access to the World API needs a key; browsing nosible.world in a browser does not.

Example: Bearer nos_sk_...

Parameters

query & path
datedaterequiredpath

Archive date in YYYY-MM-DD format.

Example: 2026-07-20

limitintegerquery

Page size.

Example: 100

sort_byenumquery

total_coverage, total_netlocs, or event_id.

Example: total_coverage

descbooleanquery

Sort descending when true.

Example: true

offsetintegerquery

Number of events to skip.

Example: 0

How to use this endpoint

guidance

Use Events for a date-scoped snapshot when you want deterministic ordering and pagination rather than relevance ranking.

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 on the date before paging.

countinteger

Events in this page.

limitinteger

Page size applied: 200 unless limit is sent.

offsetinteger

Events skipped.

sort_bystring

Sort key applied.

descboolean

Whether the sort is descending.

eventsobject[]

The events in the list format: the V2.0-preview record without its evidence and embedding (provenance, triples, availability, each ticker's why and oai_vector). Fetch Event details for those.

events[].event_idstring

Stable event identifier.

events[].versionstring

Event record version: "2.0-preview".

events[].eventobject

The event in its original language: date, language, title, description and points.

events[].event.datedate

World archive date of the event.

events[].event.languagestring

ISO 639-1 code of the event's original language.

events[].event.titlestring

Headline, in the original language.

events[].event.descriptionstring

Short narrative, in the original language.

events[].event.pointsstring[]

Key facts of the event, one sentence each.

events[].englishobject

The event in English: title, description and points, as in Event details.

events[].coverageobject

total_coverage, total_netlocs, coverage_concentration_index, first_seen, last_seen and most_seen, as in Event details.

events[].locationsobject[]

Places of the event, its own place first, then places named in it, as in Event details.

events[].signalsobject

Sentiment, materiality, time horizon and forward-looking signals with their class probabilities, as in Event details.

events[].tickersobject[]

Listed companies the event concerns, in the Event details format without why. Empty when has_tickers is false.

events[].has_tickersboolean

Whether tickers is non-empty.

events[].entitiesobject

Named entities by NER type, {TYPE: [{name, mention_count, confidence}]}, as in Event details.

events[].ontologiesobject[]

Classifications of the event, most probable first, as in Event details.

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.
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.
502backend_error — The BFF could not obtain a valid response from the World backend.
504backend_timeout — The World backend or an upstream data source timed out.