Entity directory

Enumerate raw entity names found in indexed documents, ordered by event mentions, with observed metadata for each name.

Explanation

Use the Entity Directory once per index build, then cache the pages locally. It enumerates raw entity names in mentions-desc order; each item carries the same observed metadata as Entity Profile.

GET/api/entities

Request

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

typestringquery

Optional NER type such as ORG, PERSON, or ANY.

Example: ORG

pageintegerquery

1-based page number; each page contains up to 50 entities.

Example: 1

Response

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.

schemastring

Stable entity directory contract identifier.

Example: nosible_world_entity_catalog_v1

entity_typestring|null

Optional NER type filter.

Example: ORG

orderstring

Popularity order; mentions_desc puts the most-mentioned names first.

Example: mentions_desc

pageinteger

1-based page number.

Example: 1

has_moreboolean

Whether another page exists.

Example: true

entitiesobject[]

Observed entity records with identity, date range, event count, filter, and complete indexed metadata.

Example: [{ kind, type, name, normalized, total_events, first_date, last_date, events_url, metadata, filter }]

as_ofobject

Index build and archive cutoff used for the page.

Example: { "index_build": "...", "archive_cutoff": "2026-09-16" }

Responses and errors

HTTP

200Request succeeded. The body is shown in the response example.

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.

400invalid_entity_type — The type filter is not one of the indexed NER types or ANY.

503inverted_index_unavailable — The entity directory index is not loaded; retry after the next index publish.