Skip to main content
POST
/
api
/
v1
/
events
Get aggregated events (batch)
curl --request POST \
  --url https://sacra.com/api/v1/events/ \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "start_date": "2023-12-25",
  "end_date": "2023-12-25",
  "created_at_gte": "2023-11-07T05:31:56Z",
  "created_at_lte": "2023-11-07T05:31:56Z",
  "updated_at_gte": "2023-11-07T05:31:56Z",
  "updated_at_lte": "2023-11-07T05:31:56Z",
  "company_domain": "<string>",
  "company_uid": "<string>",
  "company_id": "<string>",
  "company_domains": [
    "<string>"
  ],
  "company_ids": [
    "<string>"
  ],
  "types": "<string>",
  "subtypes": "<string>",
  "include_citations": false,
  "pagination": "page",
  "page": 123,
  "page_size": 123,
  "page_after": "<string>",
  "page_before": "<string>",
  "api_version": "v1"
}
'
{
  "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
      }
    }
  ],
  "pagination": {
    "page_size": 30,
    "current_page_items": 2,
    "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"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sacra.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Authenticate using one of two formats:

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

Body

​
start_date
string<date>

Filter events on or after this date (ISO 8601).

​
end_date
string<date>

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

​
created_at_gte
string<date-time>

Filter events created at or after this datetime.

​
created_at_lte
string<date-time>

Filter events created at or before this datetime.

​
updated_at_gte
string<date-time>

Filter events updated at or after this datetime.

​
updated_at_lte
string<date-time>

Filter events updated at or before this datetime.

​
company_domain
string

Filter by a single company domain (e.g. spacex.com).

​
company_uid
string

Filter by a single company slug/prismic UID.

​
company_id
string

Filter by a single company ID.

​
company_domains
string[]

List of company domains.

​
company_ids
string[]

List of company IDs.

​
types
string

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

​
subtypes
string

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

​
include_citations
boolean
default:false

Attach citation payloads to events.

​
pagination
enum<string>

Pagination mode. Default: page.

  • page - page
  • cursor - cursor
Available options:
page,
cursor
​
page
integer

Page number (offset pagination). Default: 1.

​
page_size
integer

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

​
page_after
string

Cursor for the next page (cursor pagination only).

​
page_before
string

Cursor for the previous page (cursor pagination only).

​
api_version
enum<string>

Response schema version. Default: v1.

  • v1 - v1
  • v0 - v0
  • legacy - legacy
Available options:
v1,
v0,
legacy

Response

Paginated list of events with metadata. Same shape as GET.

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