Skip to main content
GET
/
api
/
v1
/
events
/
Get aggregated events
curl --request GET \
  --url https://sacra.com/api/v1/events/ \
  --header 'Authorization: <api-key>'
{
  "events": [
    {
      "event_id": "st_81e849b3-c465-455f-a008-056eb4d98faa",
      "event_type": "secondary_transaction",
      "event_subtype": "tender_offer",
      "event_name": "Tender Offer (2025)",
      "event_date": "2025-12-05",
      "event_status": "announced",
      "event_last_updated_at": "2025-12-08T16:05:34.726238+00:00",
      "company": {
        "id": "325",
        "slug": "spacex",
        "domain": "spacex.com"
      },
      "data": {
        "id": "81e849b3-c465-455f-a008-056eb4d98faa",
        "updated_at": "2025-12-08T16:05:34.726238+00:00",
        "name": "Tender Offer (2025)",
        "transaction_type": "tender_offer",
        "transaction_amount": null,
        "currency": "USD",
        "valuation": "800000000000.00",
        "price_per_share": null,
        "announced_date": "2025-12-05",
        "closing_date": null,
        "created_at": "2025-12-08T16:05:34.710277+00:00",
        "status": "announced"
      }
    },
    {
      "event_id": "fr_7b3d1fed-0d27-484f-89a4-c10bec5f6d73",
      "event_type": "funding_round",
      "event_subtype": "growth",
      "event_name": "Growth 2019",
      "event_date": "2019-04-11",
      "event_status": "closed",
      "event_last_updated_at": "2025-10-24T00:25:11.439575+00:00",
      "company": {
        "id": "325",
        "slug": "spacex",
        "domain": "spacex.com"
      },
      "data": {
        "id": "7b3d1fed-0d27-484f-89a4-c10bec5f6d73",
        "updated_at": "2025-10-24T00:25:11.439575+00:00",
        "name": "Growth 2019",
        "round_type": "growth",
        "amount_raised": "510000000.00",
        "currency": "USD",
        "valuation": "30000000000.00",
        "announced_date": "2019-04-11",
        "equities": [
          {
            "name": "Series J",
            "equity_type": "preferred",
            "round_type": "series_j",
            "issue_price": "186.0000000",
            "issued_at": "2019-01-31T05:00:00+00:00",
            "updated_at": "2025-09-28T10:00:39.021272+00:00"
          }
        ],
        "status": "closed",
        "is_extension": false
      }
    },
    {
      "event_id": "ca_1708a828-f77b-483e-b32e-77121498cf1f",
      "event_type": "corporate_action",
      "event_subtype": "stock_split",
      "event_name": "10:1 Stock Split",
      "event_date": "2022-02-18",
      "event_status": "closed",
      "event_last_updated_at": "2025-10-28T16:27:32.549189+00:00",
      "company": {
        "id": "325",
        "slug": "spacex",
        "domain": "spacex.com"
      },
      "data": {
        "id": "1708a828-f77b-483e-b32e-77121498cf1f",
        "updated_at": "2025-10-28T16:27:32.549189+00:00",
        "name": "10:1 Stock Split",
        "type": "stock_split",
        "announced_date": null,
        "effective_date": "2022-02-18",
        "description": "SpaceX executed a 10-for-1 stock split.",
        "data": {},
        "status": "closed",
        "created_at": "2025-10-24T00:38:06.243482+00:00"
      }
    }
  ],
  "pagination": {
    "page_size": 30,
    "current_page_items": 3,
    "total_items": 23,
    "after_cursor": "Start",
    "before_cursor": null,
    "next_link": null,
    "prev_link": null
  },
  "meta": {
    "query_type": "single-company",
    "companies_count": 1,
    "companies": [
      {
        "id": "325",
        "slug": "spacex",
        "domain": "spacex.com"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Authenticate using one of two formats:

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

Query Parameters

​
api_version
enum<string>

API response schema version. Default: v1. Use v0/legacy for deprecated backward-compatible format.

Available options:
legacy,
v0,
v1
​
company_domain
string

Filter by a single company domain (e.g. spacex.com). Cannot combine with multi-company filters.

​
company_domains
string

Comma-separated list of company domains. Max 200 for GET requests. Cannot combine with single-company filters.

​
company_id
string

Filter by a single company ID. Cannot combine with multi-company filters.

​
company_ids
string

Comma-separated list of company IDs. Max 200 for GET requests. Cannot combine with single-company filters.

​
company_uid
string

Filter by a single company slug/prismic UID (e.g. spacex). Cannot combine with multi-company filters.

​
created_at_gte
string<date-time>

Filter events created at or after this datetime (ISO 8601).

​
created_at_lte
string<date-time>

Filter events created at or before this datetime (ISO 8601).

​
end_date
string<date>

Filter events occurring on or before this date (ISO 8601).

​
include_citations
boolean

When truthy (1, true, yes), attach citation payloads to events. Default: false.

​
page
integer

Page number (offset pagination only). Default: 1.

​
page_after
string

Cursor for the next page (cursor pagination only). Cannot combine with page_before.

​
page_before
string

Cursor for the previous page (cursor pagination only). Cannot combine with page_after.

​
page_size
integer

Results per page. Default: 30, max: 100.

​
pagination
enum<string>

Pagination mode. Default: page. cursor is recommended.

Available options:
cursor,
page
​
start_date
string<date>

Filter events occurring on or after this date (ISO 8601, e.g. 2025-01-01).

​
subtypes
string

Comma-separated event subtypes (e.g. stock_split, ipo).

​
types
string

Comma-separated event types to include: funding-round, secondary-transaction, company-milestone, corporate-action.

​
updated_at_gte
string<date-time>

Filter events updated at or after this datetime (ISO 8601). Recommended for daily polling.

​
updated_at_lte
string<date-time>

Filter events updated at or before this datetime (ISO 8601).

​
version
string

Deprecated alias for api_version. Prefer api_version.

Response

Paginated list of events with metadata.

​
events
object[]
required
​
pagination
object
required
​
meta
object
required