> ## 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. # 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). ## OpenAPI ````yaml GET /api/v1/events/ openapi: 3.0.3 info: title: Sacra API version: 1.0.0 description: >- The Sacra API currently supports querying News, Documents, Companies and Categories that enable you to use Sacra research within your own application. ## **Getting started guide** To start using the APIs, you need to: - Only available to **Platforms** and **Funds** tier members. (See [here](https://sacra.com/pricing/)) - You must use a valid API Key to send requests to the API endpoints. You can generate your API key in the Api Keys section of your [Organization Settings](https://sacra.com/orgs/settings/general/). - The API returns request responses in JSON format. When an API request returns an error, it is sent in the JSON response as an error key. ## Authentication The Sacra API uses Tokens for authentication. You can generate a Sacra API Key/Token in the Api Keys section of your [Organization Settings](https://sacra.com/orgs/settings/general/). You must include an API Key/Token in each request to the Sacra API with the **Authorization** request header. ### Authentication error response If a Token is missing, malformed, or invalid, you will receive an HTTP 401 Unauthorized response code. ### **Need some help?** In case you have questions, we will eventually provide tutorials and a FAQ page. But for now you can check out the [#developers](https://discord.gg/mTswyV8gg3) channel in our community [Discord](https://discord.gg/mTswyV8gg3), there’s a good chance our community has an answer for you. ## Authorization | **Key** | **Value** | | --- | --- | | Authorization | Token {{API_KEY}} | servers: - url: https://sacra.com description: Production security: [] tags: - name: Companies - name: Categories - name: Events - name: News - name: Documents - name: Filings - name: Embeds - name: Metrics - name: Funding (Legacy) paths: /api/v1/events/: get: tags: - Events summary: Get aggregated events description: >- 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). operationId: events_retrieve parameters: - in: query name: api_version schema: type: string enum: - legacy - v0 - v1 description: >- API response schema version. Default: `v1`. Use `v0`/`legacy` for deprecated backward-compatible format. - in: query name: company_domain schema: type: string description: >- Filter by a single company domain (e.g. `spacex.com`). Cannot combine with multi-company filters. - in: query name: company_domains schema: type: string description: >- Comma-separated list of company domains. Max 200 for GET requests. Cannot combine with single-company filters. - in: query name: company_id schema: type: string description: >- Filter by a single company ID. Cannot combine with multi-company filters. - in: query name: company_ids schema: type: string description: >- Comma-separated list of company IDs. Max 200 for GET requests. Cannot combine with single-company filters. - in: query name: company_uid schema: type: string description: >- Filter by a single company slug/prismic UID (e.g. `spacex`). Cannot combine with multi-company filters. - in: query name: created_at_gte schema: type: string format: date-time description: Filter events created at or after this datetime (ISO 8601). - in: query name: created_at_lte schema: type: string format: date-time description: Filter events created at or before this datetime (ISO 8601). - in: query name: end_date schema: type: string format: date description: Filter events occurring on or before this date (ISO 8601). - in: query name: include_citations schema: type: boolean description: >- When truthy (`1`, `true`, `yes`), attach citation payloads to events. Default: false. - in: query name: page schema: type: integer description: 'Page number (offset pagination only). Default: 1.' - in: query name: page_after schema: type: string description: >- Cursor for the next page (cursor pagination only). Cannot combine with `page_before`. - in: query name: page_before schema: type: string description: >- Cursor for the previous page (cursor pagination only). Cannot combine with `page_after`. - in: query name: page_size schema: type: integer description: 'Results per page. Default: 30, max: 100.' - in: query name: pagination schema: type: string enum: - cursor - page description: 'Pagination mode. Default: `page`. `cursor` is recommended.' - in: query name: start_date schema: type: string format: date description: >- Filter events occurring on or after this date (ISO 8601, e.g. `2025-01-01`). - in: query name: subtypes schema: type: string description: Comma-separated event subtypes (e.g. `stock_split`, `ipo`). - in: query name: types schema: type: string description: >- Comma-separated event types to include: `funding-round`, `secondary-transaction`, `company-milestone`, `corporate-action`. - in: query name: updated_at_gte schema: type: string format: date-time description: >- Filter events updated at or after this datetime (ISO 8601). Recommended for daily polling. - in: query name: updated_at_lte schema: type: string format: date-time description: Filter events updated at or before this datetime (ISO 8601). - in: query name: version schema: type: string description: Deprecated alias for `api_version`. Prefer `api_version`. deprecated: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/EventsResponse' examples: CompanyEvents: value: 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 FundingEventsWithCitations: value: events: - event_id: fr_5d304c25-b5f1-4ea8-925a-6a70de0acdb3 event_type: funding_round event_subtype: growth event_name: Growth (2025) event_date: '2025-11-17' event_status: closed event_last_updated_at: '2026-03-01T19:14:30.427412+00:00' company: id: '65' slug: ramp domain: ramp.com data: id: 5d304c25-b5f1-4ea8-925a-6a70de0acdb3 updated_at: '2026-03-01T19:14:30.427412+00:00' name: Growth (2025) round_type: growth amount_raised: '300000000.00' currency: USD valuation: '32000000000.00' announced_date: '2025-11-17' equities: [] status: closed is_extension: false citations: summary: count: 1 latest_updated_at: '2026-03-01T19:14:30.430781+00:00' items: - signal_id: ae7e7902-4e37-4463-a4e1-5f66172d00a2 signal_title: Ramp raises $300M in primary financing round captured_at: '2026-03-01T19:14:30.430781+00:00' sources: - link: >- https://techcrunch.com/2025/11/17/ramp-hits-32b-valuation-just-three-months-after-hitting-22-5b headline: >- Ramp hits $32B valuation, just 3 months after hitting $22.5B quote: null publication: techcrunch.com type: article pagination: page_size: 30 current_page_items: 1 total_items: 1 after_cursor: Start before_cursor: null next_link: null prev_link: null meta: query_type: single-company companies_count: 1 companies: - id: '65' slug: ramp domain: ramp.com description: >- Response shape when querying funding rounds with `include_citations=true`. DailyPollingEvents: value: events: - event_id: st_0c601c12-6213-4093-8e5b-90febbb1056e event_type: secondary_transaction event_subtype: institutional_secondary event_name: Direct Sale (2025) event_date: '2025-09-01' event_status: closed event_last_updated_at: '2026-01-13T18:03:42.923112+00:00' company: id: '407' slug: revolut domain: revolut.com data: id: 0c601c12-6213-4093-8e5b-90febbb1056e updated_at: '2026-01-13T18:03:42.923112+00:00' name: Direct Sale (2025) transaction_type: institutional_secondary transaction_amount: '1000000000.00' currency: USD valuation: '75000000000.00' price_per_share: '1381.06' announced_date: '2025-09-01' closing_date: '2025-09-05' created_at: '2025-10-24T01:19:34.954929+00:00' status: closed pagination: page_size: 30 current_page_items: 1 total_items: 1 after_cursor: Start before_cursor: null next_link: null prev_link: null meta: query_type: global companies_count: 1 companies: - id: '407' slug: revolut domain: revolut.com description: >- Global query using updated_at_gte/updated_at_lte for daily polling. Shows institutional_secondary transaction with price_per_share. TypeFilterFundingRounds: value: events: - event_id: fr_510d3c08-c5e2-4850-9f17-f97f0758efe3 event_type: funding_round event_subtype: growth event_name: Growth (2025) event_date: '2025-11-17' event_status: cancelled event_last_updated_at: '2025-12-08T17:22:15.071608+00:00' company: id: '325' slug: spacex domain: spacex.com data: id: 510d3c08-c5e2-4850-9f17-f97f0758efe3 updated_at: '2025-12-08T17:22:15.071608+00:00' name: Growth (2025) round_type: growth amount_raised: '134000000.00' currency: USD valuation: null announced_date: '2025-11-17' equities: [] status: cancelled is_extension: false pagination: page_size: 30 current_page_items: 1 total_items: 15 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 description: >- Filtered by types=funding-round. Shows funding round data shape with round_type, amount_raised, equities. EmptyResults: value: events: [] pagination: page: 1 page_size: 30 total_pages: 0 total_count: 0 has_next: false has_previous: false meta: query_type: single-company companies_count: 0 companies: [] description: Empty result with offset-based pagination (default mode). description: Paginated list of events with metadata. '400': content: text/plain: schema: type: string example: Date range must be 14 days or less for global queries description: Invalid parameters. '404': content: text/plain: schema: type: string example: 'Company not found for id(s): [''999'']' description: One or more requested company IDs or domains were not found. '500': content: text/plain: schema: type: string example: Internal server error description: Internal server error. security: - SacraAPIAuthentication: [] components: schemas: EventsResponse: type: object properties: events: type: array items: $ref: '#/components/schemas/Event' pagination: $ref: '#/components/schemas/EventsPagination' meta: $ref: '#/components/schemas/EventsMeta' required: - events - meta - pagination Event: type: object properties: event_id: type: string description: Prefixed ID (e.g. `fr_`, `st_`, `ca_`, `cm_`). event_type: type: string description: >- One of `secondary_transaction`, `funding_round`, `corporate_action`, `company_milestone`. event_subtype: type: string nullable: true description: e.g. `tender_offer`, `growth`, `stock_split`, `ipo`. event_name: type: string event_date: type: string event_status: type: string description: e.g. `announced`, `closed`, `cancelled`. event_last_updated_at: type: string format: date-time company: $ref: '#/components/schemas/EventCompanyRef' data: type: object additionalProperties: {} description: >- Event-specific payload. Shape varies by `event_type`. Funding rounds include `round_type`, `amount_raised`, `valuation`, `equities`. Secondary transactions include `transaction_type`, `transaction_amount`, `price_per_share`. Corporate actions include `type`, `effective_date`, `description`. citations: $ref: '#/components/schemas/EventCitations' required: - company - data - event_date - event_id - event_last_updated_at - event_name - event_status - event_subtype - event_type EventsPagination: type: object properties: page_size: type: integer current_page_items: type: integer total_items: type: integer after_cursor: type: string nullable: true before_cursor: type: string nullable: true next_link: type: string nullable: true prev_link: type: string nullable: true required: - after_cursor - before_cursor - current_page_items - next_link - page_size - prev_link - total_items EventsMeta: type: object properties: query_type: type: string description: One of `single-company`, `multi-company`, `global`. companies_count: type: integer companies: type: array items: $ref: '#/components/schemas/EventsMetaCompany' required: - companies - companies_count - query_type EventCompanyRef: type: object properties: id: type: string slug: type: string domain: type: string required: - domain - id - slug EventCitations: type: object properties: summary: $ref: '#/components/schemas/EventCitationsSummary' items: type: array items: $ref: '#/components/schemas/EventCitationItem' required: - items - summary EventsMetaCompany: type: object properties: id: type: string slug: type: string domain: type: string required: - domain - id - slug EventCitationsSummary: type: object properties: count: type: integer latest_updated_at: type: string format: date-time nullable: true required: - count - latest_updated_at EventCitationItem: type: object properties: signal_id: type: string nullable: true description: Identifier for the underlying fact/signal linked to these sources. signal_title: type: string nullable: true captured_at: type: string format: date-time nullable: true sources: type: array items: $ref: '#/components/schemas/EventCitationSource' required: - captured_at - signal_id - signal_title - sources EventCitationSource: type: object properties: link: type: string format: uri headline: type: string nullable: true quote: type: string nullable: true publication: type: string nullable: true type: type: string required: - headline - link - publication - quote - type securitySchemes: SacraAPIAuthentication: type: apiKey in: header name: Authorization description: |- Authenticate using one of two formats: - **Organization/user token:** `Token ` - **Stytch JWT:** `Bearer ` ````