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