Skip to main content
GET
/
api
/
v1
/
companies
/
List companies
curl --request GET \
  --url https://sacra.com/api/v1/companies/ \
  --header 'Authorization: <api-key>'
{
  "companies": [
    {
      "id": 596,
      "domain": "rallyon.com",
      "name": "Rally"
    },
    {
      "id": 416,
      "domain": "contentful.com",
      "name": "Contentful"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Authenticate using one of two formats:

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

Query Parameters

​
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, 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

Flat company list or sync-mode paginated list depending on parameters.

​
companies
object[]
required

Returned in list mode and sync mode.

​
pagination
object