Get aggregated events

curl --request GET \
  --url https://sacra.com/api/v1/events/ \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://sacra.com/api/v1/events/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sacra.com/api/v1/events/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sacra.com/api/v1/events/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sacra.com/api/v1/events/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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"
      }
    ]
  }
}

Events

Get aggregated events

Returns aggregated events from funding rounds, secondary transactions, company milestones, and corporate actions in chronological order.

Pagination modes:

page (default): Offset-based pagination via page and page_size.
cursor: Cursor-based pagination via page_after / page_before. Recommended.

Global queries (no company filter) require at least one date range (start_date, created_at_gte, or updated_at_gte) spanning 14 days or less.

API versioning: Defaults to v1 (snake_case, detailed status). Pass api_version=v0 for the deprecated legacy schema (kebab-case, binary status).

GET

api

events

Get aggregated events

curl --request GET \
  --url https://sacra.com/api/v1/events/ \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://sacra.com/api/v1/events/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sacra.com/api/v1/events/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://sacra.com/api/v1/events/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://sacra.com/api/v1/events/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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

Show child attributes

pagination

object

required

Show child attributes

API reference

Companies

Documents

Events

News

Filings

Metrics

Embeds

Categories

Funding (legacy)

Get aggregated events

Authorizations

Query Parameters

Response