GET /v1/companies
Lists the companies your token can read, with the size and span of each one's
history. Use it to discover the domains you can pass to
/v1/events. It takes no parameters.
curl -H "Authorization: Bearer YOUR_TOKEN" \
"https://api.docsignal.app/v1/companies"
{
"companies": [
{
"domain": "linear.app",
"name": "Linear",
"category": "product-led-saas",
"shipped_from": "2019-04-11",
"observed_from": "2026-07-19T00:00:00Z",
"events": 608,
"dated_events": 588
}
]
}
| Field | Meaning |
|---|---|
domain | What to pass in domains on /v1/events. |
shipped_from | The earliest ship date we hold for this company. |
observed_from | When we began observing it. |
events | Total events we hold. |
dated_events | How many of those carry a shipped_at. |
observed_from is when tracking began for that company. History starts
there.
Aliases
Some companies publish under more than one domain, and the alias resolves to the
canonical one. devin.ai resolves to cognition.ai, claude.com to
anthropic.com. The query block in the response tells you which domain your
request actually resolved to.