Skip to main content

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
}
]
}
FieldMeaning
domainWhat to pass in domains on /v1/events.
shipped_fromThe earliest ship date we hold for this company.
observed_fromWhen we began observing it.
eventsTotal events we hold.
dated_eventsHow 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.