Organisations

Overview

Organisations are the one thing the domains share: the company that filed, the sponsor that ran the trial, the university that was funded, the labeller on the drug. 4.58M of them, 5.52M aliases, 5.30M links reaching 2.66M documents — so “what has this company been up to” is one lookup and then one call per domain, instead of a name match in each.

A link is not always an identifier. 1.09M were matched on a CIK or a ticker, 1.13M on a name that is unambiguous, and 3.08M by adjudicating 79,867 spellings with a model (mean confidence 0.81). Every link says which it was — method is id, exact_unique or llm, the last with a score — so a reader can weigh it. One organisation often holds ids in several registries at once, a university with its ROR and its EDGAR cik and its GLEIF lei, and all of them come back together.

linked: filings 1.09M of 1.09M · grants 1.03M of 1.31M · trials 510k of 600k · drugs 31k of 257k

Drugs are thin on purpose: most labellers are small repackagers that no registry lists. Federal Register issuers and CVE vendors are next.

Find an organisation

GET/v1/entities?q={q}

4.58M organisations with 5.52M aliases. Returns candidates, never a single guess — matched_by is exact, fuzzy (with a similarity) or none. A parent and its subsidiary are occasionally merged upstream, so let a person pick. 2 credits.

Parameters

Parameter	Type	Description
q REQUIRED	string	Name, ticker or identifier.
limit	integer= 5	Candidates to return.

Example

{ "matched_by": "exact",
  "entities": [ { "entity_id": "cik:1682852", "kind": "company", "name": "Moderna, Inc.", "country": "US",
                  "ids": { "cik": "1682852", "tickers": ["MRNA"] },
                  "documents": { "filings": 315, "trials": 1 }, "matched_alias": "Moderna", "similarity": 1.0 } ] }

One organisation

GET/v1/entities/{entity_id}

The entity with its aliases and a count of documents per domain. 1 credit.

Parameters

Parameter	Type	Description
entity_id (path) REQUIRED	string	From a search hit: `cik:` (SEC), `lei:` (GLEIF), `ror:` (research organisations), `cn:` (A-share).

What it has filed, run, been funded for

GET/v1/entities/{entity_id}/docs

5.30M links over 2.66M documents, across filings, trials, grants and drugs. Each carries method — id (matched on CIK or ticker, the firm ground), exact_unique (one unambiguous name) or llm (a judgement, with a score) — so a reader can weigh it. 3 credits; level=none returns the links without the cards and costs less.

Parameters

Parameter	Type	Description
entity_id (path) REQUIRED	string	From a search hit: `cik:` (SEC), `lei:` (GLEIF), `ror:` (research organisations), `cn:` (A-share).
domain	filings · trials · grants · drugs	One domain, or leave empty for all that have links.
top_k	integer= 20	1–100.
level	brief · none= brief	`none` skips the document cards.

Example

{ "docs": [ { "domain": "filings", "id": "us:1682852:0001682852-24-000016", "matched_on": "cik",
                "mention": "Moderna, Inc.", "method": "id", "brief": { … } } ] }

Links exist for filings, grants, trials and drugs today; the shape will not change as more domains join. Each domain’s extra_endpoints.entities points back here.