Skip to main content
GET
List companies
Use this endpoint to discover the companies Sacra covers or identify companies whose research and data changed during a time window. The request supports three response modes:
Looking for one company? See Get company detail for lookup by domain, ID, or slug. The query identifier parameters shown below return a single company object rather than filtering the collection.
Provide exactly one of company_domain, id, or company_slug. Do not combine a company identifier with mode=sync.

List company coverage

Call the endpoint without query parameters to return all active companies in Sacra’s coverage universe. The lightweight response is useful for populating a company picker or building a local mapping between company IDs and domains.

Find recently updated companies

Set mode=sync to find companies whose selected data sources changed during an ISO 8601 time window. Each result includes updated_at and updated_sources, so you can decide which company or downstream resource to refresh. A sync window can span no more than 14 days. Use sources to monitor one or more comma-separated sources, such as documents,news,metrics. Use sources=all to include every supported source.
Sync responses contain up to 30 companies by default and support a maximum page size of 100. Follow pagination.next_link until it is null to retrieve every company in the window. The link preserves the time window, source filters, page size, and cursor for the next request.

Authorizations

Authorization
string
header
required

Authenticate using one of two formats:

  • Organization/user token: Token <your-token>
  • Stytch JWT: Bearer <your-jwt>

Query Parameters

company_domain
string

Company domain to look up (for example, stripe.com). Returns the full detail payload. Cannot be combined with mode=sync.

company_slug
string

Company slug to look up (for example, stripe). Returns the full detail payload. Cannot be combined with mode=sync.

id
integer

Company ID to look up. Returns the full detail payload. Cannot be combined with mode=sync.

mode
enum<string>

Set to sync to use paginated sync mode.

Available options:
sync
page_after
string

Cursor for the next page. Pass a company ID or start. Only for mode=sync. Cannot be combined with page_before.

page_before
string

Cursor for the previous page. Pass a company ID or end. Only for mode=sync. Cannot be combined with page_after.

page_size
integer

Results per page, 1-100. Default 30. Only applies to mode=sync.

sources
string

Source filter for mode=sync. Accepts documents, news, events, datasets, metrics (including last-valuation projections), filings, listings, or all.

updated_at_gte
string<date-time>

ISO 8601 datetime. Required when mode=sync. Inclusive lower bound for the updated_at window.

updated_at_lte
string<date-time>

ISO 8601 datetime. Optional upper bound for mode=sync (defaults to now). The window must be 14 days or less.

Response

A flat company list, one full company detail payload, or a sync-mode paginated list depending on parameters.

companies
object[]
required

Returned in list mode and sync mode.

pagination
object