Entity directory

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

GET/api/entities

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

How to use this endpoint

guidance

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.

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 response body is shown in the panel on the right.

400invalid_request — The date, filter, cursor, identifier, or request combination is invalid.

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.

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.

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.