> ## 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.

# Events v0 (MVP) to v1

> Migration guide and changelog for the Events API v1 schema

## Executive summary

The Events API is introducing a final v1 schema to improve data accuracy, consistency, and clarity. This document outlines all changes between the legacy v0 MVP schema and the new v1 schema.

**v1 became the default on November 19.**

### What's changing

* **Event type format**: kebab-case to snake\_case (`funding-round` to `funding_round`)
* **Status terminology**: `planned` to `announced` for clarity
* **Round type accuracy**: Generic `equity` type split into specific `growth` and `crowdfunding` types
* **Model separation**: `CorporateAction` now distinct from `CompanyMilestone`
* **New fields**: `event_name` and `event_status` at envelope level, `closing_date` for SecondaryTransactions, `is_extension` for FundingRounds

### Migration timeline

* **Current status**: v1 is opt-in via `?version=v1` query parameter
* **Default**: v0 schema (for backward compatibility)
* **Migration period**: v1 default will be in effect November 19
* **Future**: v1 will become default (v0 will be deprecated but you can still query for v0)

### Impact assessment

* **Breaking changes**: Yes -- response format changes require client code updates
* **Backward compatibility**: v0 remains default during migration period
* **Action required**: Test with `?version=v1`, update client code, migrate before deadline

***

## Breaking changes

### 1. Event type format change

Event types have changed from kebab-case to snake\_case for consistency with industry standards.

| Entity               | v0 (Legacy)             | v1                      |
| -------------------- | ----------------------- | ----------------------- |
| FundingRound         | `funding-round`         | `funding_round`         |
| SecondaryTransaction | `secondary-transaction` | `secondary_transaction` |
| CorporateAction      | `company-milestone`     | `corporate_action`      |
| CompanyMilestone     | `company-milestone`     | `company_milestone`     |

**Impact**: Code that checks `event_type` in responses must be updated.

```python theme={null}
# v0
if event['event_type'] == 'funding-round':
    process_funding_round(event)

# v1
if event['event_type'] == 'funding_round':
    process_funding_round(event)
```

<Note>
  The `types` **query parameter** still uses kebab-case in both v0 and v1 (e.g. `?types=funding-round`). Only the `event_type` field in the **response** changed to snake\_case.
</Note>

<Note>
  In v0, `CorporateAction` and `CompanyMilestone` were both returned as `company-milestone`. In v1, they are distinct types.
</Note>

***

### 2. Status field terminology

The status terminology has changed from `planned` to `announced` for better clarity about event lifecycle.

| Status meaning              | v0 (Legacy) | v1          |
| --------------------------- | ----------- | ----------- |
| Announced but not completed | `planned`   | `announced` |
| Completed/finalized         | `closed`    | `closed`    |
| Cancelled/abandoned         | `cancelled` | `cancelled` |

```python theme={null}
# v0
if event['data']['status'] == 'planned':
    mark_as_upcoming(event)

# v1
if event['data']['status'] == 'announced':
    mark_as_upcoming(event)
```

***

### 3. Round type accuracy

v1 exposes accurate round types instead of generic mappings. The generic `equity` type has been split into specific types.

| Actual round type | v0 (Legacy)           | v1                    |
| ----------------- | --------------------- | --------------------- |
| Growth round      | `equity`              | `growth`              |
| Crowdfunding      | `equity`              | `crowdfunding`        |
| Strategic         | `strategic`           | `strategic`           |
| Seed              | `seed`                | `seed`                |
| Series A-N        | `series_a`-`series_n` | `series_a`-`series_n` |

**Impact**: Generic `equity` type no longer exists in v1. Clients filtering or processing by round type must update logic.

```python theme={null}
# v0
if event['data']['round_type'] == 'equity':
    # Could be growth OR crowdfunding - ambiguous
    process_equity_round(event)

# v1
if event['data']['round_type'] in ['growth', 'crowdfunding']:
    if event['data']['round_type'] == 'growth':
        process_growth_round(event)
    elif event['data']['round_type'] == 'crowdfunding':
        process_crowdfunding_round(event)
```

***

### 4. CorporateAction vs CompanyMilestone separation

v1 introduces a distinct `CorporateAction` entity type, separating capital structure changes from general company milestones.

**v0**: Both corporate actions (stock splits, recaps) and company milestones (IPOs, incorporations) returned as `company-milestone`.

**v1**: Distinct types:

* `corporate_action`: Stock splits, reverse splits, recapitalizations
* `company_milestone`: IPOs, incorporations, delistings

**Impact**: Filtering by `types=company-milestone` in v0 returned both. In v1, you must specify which type you want.

```bash theme={null}
# v0 (gets both corporate actions and milestones)
GET /api/v1/events/?types=company-milestone

# v1 (must specify which you want)
GET /api/v1/events/?version=v1&types=corporate-action
GET /api/v1/events/?version=v1&types=company-milestone
GET /api/v1/events/?version=v1&types=corporate-action,company-milestone
```

***

### 5. New field: `event_status` at envelope level

v1 adds `event_status` at the event envelope level (in addition to `data.status`) for easier filtering without parsing nested data.

```json theme={null}
// v0 - No event_status at top level
{
  "event_id": "fr_abc123",
  "event_type": "funding-round",
  "event_date": "2024-10-02",
  "data": {
    "status": "closed"
  }
}
```

```json theme={null}
// v1 - event_status at envelope level
{
  "event_id": "fr_abc123",
  "event_type": "funding_round",
  "event_date": "2024-10-02",
  "event_status": "closed",
  "data": {
    "status": "closed"
  }
}
```

***

### 6. New field: `closing_date` for SecondaryTransactions

v1 adds the `closing_date` field to SecondaryTransaction events to distinguish between announcement and completion dates.

**Smart inference**: If `event_status: "closed"` but `closing_date` is null, the API automatically sets `closing_date = announced_date` in the response (indicating "we know it closed, but only have one date").

```json theme={null}
// v0 - No closing_date field
{
  "event_type": "secondary-transaction",
  "data": {
    "announced_date": "2024-08-15",
    "status": "closed"
  }
}
```

```json theme={null}
// v1 - closing_date available
{
  "event_type": "secondary_transaction",
  "event_status": "closed",
  "data": {
    "announced_date": "2024-08-15",
    "closing_date": "2024-09-29",
    "status": "closed"
  }
}
```

```json theme={null}
// v1 - closing_date inferred (when only one date known)
{
  "event_type": "secondary_transaction",
  "event_status": "closed",
  "data": {
    "announced_date": "2024-11-27",
    "closing_date": "2024-11-27",
    "status": "closed"
  }
}
```

***

### 7. New field: `event_name` at envelope level

v1 adds `event_name` to the event envelope for easier timeline/visualization rendering without parsing nested data.

```json theme={null}
// v0 - Name buried in nested data
{
  "event_id": "fr_abc123",
  "event_type": "funding-round",
  "event_date": "2024-10-02",
  "data": {
    "name": "Series A 2024"
  }
}
```

```json theme={null}
// v1 - Name at envelope level
{
  "event_id": "fr_abc123",
  "event_type": "funding_round",
  "event_name": "Series A 2024",
  "event_date": "2024-10-02",
  "data": {
    "name": "Series A 2024"
  }
}
```

Use case -- timeline visualization:

```javascript theme={null}
// v1 - Clean timeline rendering with just envelope data
events.map(e => ({
  date: e.event_date,
  name: e.event_name,
  type: e.event_type
}))

// v0 - Requires parsing nested data
events.map(e => ({
  date: e.event_date,
  name: e.data.name || e.data.label,
  type: e.event_type
}))
```

***

### 8. New field: `is_extension` for FundingRounds

v1 adds the `is_extension` boolean field to identify funding rounds that extend or follow on from a previous round.

Use cases:

* Identify multiple closes of the same series
* Calculate total capital by series (base + extensions)
* Detect reclassified growth rounds

```json theme={null}
// v0 - No way to distinguish base vs extension rounds
{
  "event_type": "funding-round",
  "data": {
    "round_type": "series_e",
    "amount_raised": "500000000.00"
  }
}
```

```json theme={null}
// v1 - is_extension field identifies extensions
{
  "event_type": "funding_round",
  "data": {
    "round_type": "series_e",
    "amount_raised": "500000000.00",
    "is_extension": true
  }
}
```

***

## Side-by-side field comparison

### Event envelope fields

| Field                   | v0               | v1                | Notes                      |
| ----------------------- | ---------------- | ----------------- | -------------------------- |
| `event_id`              | Yes              | Yes               | Unchanged                  |
| `event_type`            | Yes (kebab-case) | Yes (snake\_case) | Format changed             |
| `event_subtype`         | Yes              | Yes               | May differ for round types |
| `event_name`            | No               | Yes               | **New** in v1              |
| `event_date`            | Yes              | Yes               | Unchanged                  |
| `event_status`          | No               | Yes               | **New** in v1              |
| `event_last_updated_at` | Yes              | Yes               | Unchanged                  |
| `company`               | Yes              | Yes               | Unchanged                  |
| `data`                  | Yes              | Yes               | Structure varies by type   |

### FundingRound data fields

| Field            | v0                     | v1                                     | Notes               |
| ---------------- | ---------------------- | -------------------------------------- | ------------------- |
| `id`             | Yes                    | Yes                                    | Unchanged           |
| `name`           | Yes                    | Yes                                    | Unchanged           |
| `round_type`     | Yes (`equity` generic) | Yes (`growth`/`crowdfunding` specific) | More accurate in v1 |
| `amount_raised`  | Yes                    | Yes                                    | Unchanged           |
| `currency`       | Yes                    | Yes                                    | Unchanged           |
| `valuation`      | Yes                    | Yes                                    | Unchanged           |
| `announced_date` | Yes                    | Yes                                    | Unchanged           |
| `equities`       | Yes                    | Yes                                    | Unchanged           |
| `status`         | Yes (`planned`)        | Yes (`announced`)                      | Terminology changed |
| `is_extension`   | No                     | Yes                                    | **New** in v1       |
| `created_at`     | Yes                    | Yes                                    | Unchanged           |
| `updated_at`     | Yes                    | Yes                                    | Unchanged           |

### SecondaryTransaction data fields

| Field                | v0              | v1                | Notes               |
| -------------------- | --------------- | ----------------- | ------------------- |
| `id`                 | Yes             | Yes               | Unchanged           |
| `name`               | Yes             | Yes               | Unchanged           |
| `transaction_type`   | Yes             | Yes               | Unchanged           |
| `transaction_amount` | Yes             | Yes               | Unchanged           |
| `currency`           | Yes             | Yes               | Unchanged           |
| `valuation`          | Yes             | Yes               | Unchanged           |
| `price_per_share`    | Yes             | Yes               | Unchanged           |
| `announced_date`     | Yes             | Yes               | Unchanged           |
| `closing_date`       | No              | Yes               | **New** in v1       |
| `status`             | Yes (`planned`) | Yes (`announced`) | Terminology changed |
| `created_at`         | Yes             | Yes               | Unchanged           |
| `updated_at`         | Yes             | Yes               | Unchanged           |

### CorporateAction (v1) vs CompanyMilestone (v0)

In v0, corporate actions were returned as `company-milestone` with a simplified schema. In v1, they have their own distinct type and richer schema.

v0 schema (as `company-milestone`):

```json theme={null}
{
  "event_type": "company-milestone",
  "event_subtype": "stock_split",
  "data": {
    "id": "...",
    "type": "stock_split",
    "date": "2019-03-01",
    "label": "Stock Split",
    "description": "2-for-1 stock split",
    "data": {"split_ratio": "2:1"}
  }
}
```

v1 schema (as `corporate_action`):

```json theme={null}
{
  "event_type": "corporate_action",
  "event_subtype": "stock_split",
  "event_status": "closed",
  "data": {
    "id": "...",
    "name": "2-for-1 Stock Split",
    "type": "stock_split",
    "announced_date": "2019-02-15",
    "effective_date": "2019-03-01",
    "description": "2-for-1 stock split",
    "data": {"split_ratio": "2:1"},
    "status": "closed"
  }
}
```

Key differences:

1. `event_type` changed from `company-milestone` to `corporate_action`
2. New `announced_date` field (separate from `effective_date`)
3. New `event_status` at envelope level
4. `name` field replaces simplified `label`
5. `status` field added to data

***

## Complete migration example

### v0 response (legacy)

<Accordion title="Full v0 response for Ramp events">
  ```json theme={null}
  {
    "events": [
      {
        "event_id": "fr_7d94ae1b-b989-4345-af37-19a78068c5eb",
        "event_type": "funding-round",
        "event_subtype": "series_e",
        "event_date": "2025-07-30",
        "event_last_updated_at": "2025-10-27T13:38:35.316863+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "7d94ae1b-b989-4345-af37-19a78068c5eb",
          "updated_at": "2025-10-27T13:38:35.316863+00:00",
          "name": "Series E (2025) Extension",
          "round_type": "series_e",
          "amount_raised": "500000000.00",
          "currency": "USD",
          "valuation": "22500000000.00",
          "announced_date": "2025-07-30",
          "equities": [
            {
              "name": "Series E-2",
              "equity_type": "preferred",
              "round_type": "series_e",
              "issue_price": "65.0000000",
              "issued_at": "2025-07-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.038010+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_ca9560a0-8793-493c-8ced-64be4a290161",
        "event_type": "funding-round",
        "event_subtype": "series_e",
        "event_date": "2025-06-17",
        "event_last_updated_at": "2025-10-24T01:12:18.330534+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "ca9560a0-8793-493c-8ced-64be4a290161",
          "updated_at": "2025-10-24T01:12:18.330534+00:00",
          "name": "Series E (2025)",
          "round_type": "series_e",
          "amount_raised": "200000000.00",
          "currency": "USD",
          "valuation": "16000000000.00",
          "announced_date": "2025-06-17",
          "equities": [
            {
              "name": "Series E",
              "equity_type": "preferred",
              "round_type": "series_e",
              "issue_price": "47.5000000",
              "issued_at": "2025-06-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.034948+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "st_a7cecea9-634d-494d-bd0a-45779d4099a5",
        "event_type": "secondary-transaction",
        "event_subtype": "tender_offer",
        "event_date": "2025-03-03",
        "event_last_updated_at": "2025-10-24T01:12:36.485984+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "a7cecea9-634d-494d-bd0a-45779d4099a5",
          "updated_at": "2025-10-24T01:12:36.485984+00:00",
          "name": "Tender Offer (2025)",
          "transaction_type": "tender_offer",
          "transaction_amount": null,
          "currency": "USD",
          "valuation": "13000000000.00",
          "price_per_share": null,
          "announced_date": "2025-03-03",
          "created_at": "2025-10-24T01:12:36.478896+00:00",
          "status": "closed"
        }
      },
      {
        "event_id": "fr_2464d613-61d6-4bee-86c7-0ddf84f674b2",
        "event_type": "funding-round",
        "event_subtype": "series_d",
        "event_date": "2024-04-17",
        "event_last_updated_at": "2025-10-27T13:38:31.212436+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "2464d613-61d6-4bee-86c7-0ddf84f674b2",
          "updated_at": "2025-10-27T13:38:31.212436+00:00",
          "name": "Series D (2024) Extension",
          "round_type": "series_d",
          "amount_raised": "150000000.00",
          "currency": "USD",
          "valuation": "7650000000.00",
          "announced_date": "2024-04-17",
          "equities": [
            {
              "name": "Series D",
              "equity_type": "preferred",
              "round_type": "series_d",
              "issue_price": "20.0000000",
              "issued_at": "2024-04-25T19:16:00+00:00",
              "updated_at": "2025-10-24T01:18:05.027279+00:00"
            },
            {
              "name": "Series D-2",
              "equity_type": "preferred",
              "round_type": "series_d",
              "issue_price": "25.0000000",
              "issued_at": "2024-04-25T19:16:00+00:00",
              "updated_at": "2025-10-24T01:18:05.031694+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_35405edb-2e8a-4e07-b517-d080e0c832f0",
        "event_type": "funding-round",
        "event_subtype": "series_d",
        "event_date": "2023-08-22",
        "event_last_updated_at": "2025-10-24T01:14:33.375472+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "35405edb-2e8a-4e07-b517-d080e0c832f0",
          "updated_at": "2025-10-24T01:14:33.375472+00:00",
          "name": "Series D (2023)",
          "round_type": "series_d",
          "amount_raised": "300000000.00",
          "currency": "USD",
          "valuation": "5800000000.00",
          "announced_date": "2023-08-22",
          "equities": [],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_d3a7773c-e3df-4b9b-8711-8e699213c2b5",
        "event_type": "funding-round",
        "event_subtype": "series_c",
        "event_date": "2022-03-21",
        "event_last_updated_at": "2025-10-27T13:38:26.703499+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "d3a7773c-e3df-4b9b-8711-8e699213c2b5",
          "updated_at": "2025-10-27T13:38:26.703499+00:00",
          "name": "Growth (2022) Extension",
          "round_type": "series_c",
          "amount_raised": "200000000.00",
          "currency": "USD",
          "valuation": "8100000000.00",
          "announced_date": "2022-03-21",
          "equities": [
            {
              "name": "Series C-3",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "30.0000000",
              "issued_at": "2022-03-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:19:34.939585+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_362bcaa9-e77d-488b-8562-9aa2ccd4ec70",
        "event_type": "funding-round",
        "event_subtype": "series_c",
        "event_date": "2021-08-24",
        "event_last_updated_at": "2025-10-24T01:13:06.683649+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "362bcaa9-e77d-488b-8562-9aa2ccd4ec70",
          "updated_at": "2025-10-24T01:13:06.683649+00:00",
          "name": "Series C (2021)",
          "round_type": "series_c",
          "amount_raised": "300000000.00",
          "currency": "USD",
          "valuation": "3900000000.00",
          "announced_date": "2021-08-24",
          "equities": [
            {
              "name": "Series C-2",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "6.6808000",
              "issued_at": "2021-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.017683+00:00"
            },
            {
              "name": "Series C-1",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "15.0000000",
              "issued_at": "2021-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.023665+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_c56cfcaa-a00b-4279-8ee2-413114a499d4",
        "event_type": "funding-round",
        "event_subtype": "series_b",
        "event_date": "2021-04-08",
        "event_last_updated_at": "2025-10-24T01:12:55.156817+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "c56cfcaa-a00b-4279-8ee2-413114a499d4",
          "updated_at": "2025-10-24T01:12:55.156817+00:00",
          "name": "Series B (2021)",
          "round_type": "series_b",
          "amount_raised": "115000000.00",
          "currency": "USD",
          "valuation": "1600000000.00",
          "announced_date": "2021-04-08",
          "equities": [
            {
              "name": "Series B",
              "equity_type": "preferred",
              "round_type": "series_b",
              "issue_price": "4.7517200",
              "issued_at": "2021-04-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.012209+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_6960aea5-9834-4c13-a39c-9e3a6d1b7c7c",
        "event_type": "funding-round",
        "event_subtype": "series_a",
        "event_date": "2020-08-01",
        "event_last_updated_at": "2025-10-27T13:38:20.319450+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "6960aea5-9834-4c13-a39c-9e3a6d1b7c7c",
          "updated_at": "2025-10-27T13:38:20.319450+00:00",
          "name": "Series A (2020) Extension",
          "round_type": "series_a",
          "amount_raised": "30000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2020-08-01",
          "equities": [
            {
              "name": "Series A-4",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.7105800",
              "issued_at": "2020-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.998671+00:00"
            },
            {
              "name": "Series A-3",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "1.0213600",
              "issued_at": "2020-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.008617+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_88b1a90e-0a20-4285-9eff-414b45573d4f",
        "event_type": "funding-round",
        "event_subtype": "series_a",
        "event_date": "2020-02-12",
        "event_last_updated_at": "2025-10-24T01:14:19.736753+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "88b1a90e-0a20-4285-9eff-414b45573d4f",
          "updated_at": "2025-10-24T01:14:19.736753+00:00",
          "name": "Series A (2020)",
          "round_type": "series_a",
          "amount_raised": "15000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2020-02-12",
          "equities": [
            {
              "name": "Series A-2",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.2561400",
              "issued_at": "2020-01-31T05:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.987879+00:00"
            },
            {
              "name": "Series A-1",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.5763200",
              "issued_at": "2020-01-31T05:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.993509+00:00"
            }
          ],
          "status": "closed"
        }
      },
      {
        "event_id": "fr_4f656e60-48be-4862-aaff-df62ffb9fa94",
        "event_type": "funding-round",
        "event_subtype": "seed",
        "event_date": "2019-08-01",
        "event_last_updated_at": "2025-10-24T01:13:18.484702+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "4f656e60-48be-4862-aaff-df62ffb9fa94",
          "updated_at": "2025-10-24T01:13:18.484702+00:00",
          "name": "Seed (2019)",
          "round_type": "seed",
          "amount_raised": "8000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2019-08-01",
          "equities": [
            {
              "name": "Series Seed",
              "equity_type": "preferred",
              "round_type": "seed",
              "issue_price": "0.2105000",
              "issued_at": "2019-06-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.982651+00:00"
            }
          ],
          "status": "closed"
        }
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 30,
      "total_pages": 1,
      "total_count": 11,
      "has_next": false,
      "has_previous": false
    }
  }
  ```
</Accordion>

### v1 response

<Accordion title="Full v1 response for Ramp events">
  ```json theme={null}
  {
    "events": [
      {
        "event_id": "fr_7d94ae1b-b989-4345-af37-19a78068c5eb",
        "event_type": "funding_round",
        "event_subtype": "series_e",
        "event_name": "Series E (2025) Extension",
        "event_date": "2025-07-30",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-27T13:38:35.316863+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "7d94ae1b-b989-4345-af37-19a78068c5eb",
          "updated_at": "2025-10-27T13:38:35.316863+00:00",
          "name": "Series E (2025) Extension",
          "round_type": "series_e",
          "amount_raised": "500000000.00",
          "currency": "USD",
          "valuation": "22500000000.00",
          "announced_date": "2025-07-30",
          "equities": [
            {
              "name": "Series E-2",
              "equity_type": "preferred",
              "round_type": "series_e",
              "issue_price": "65.0000000",
              "issued_at": "2025-07-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.038010+00:00"
            }
          ],
          "status": "closed",
          "is_extension": true
        }
      },
      {
        "event_id": "fr_ca9560a0-8793-493c-8ced-64be4a290161",
        "event_type": "funding_round",
        "event_subtype": "series_e",
        "event_name": "Series E (2025)",
        "event_date": "2025-06-17",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:12:18.330534+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "ca9560a0-8793-493c-8ced-64be4a290161",
          "updated_at": "2025-10-24T01:12:18.330534+00:00",
          "name": "Series E (2025)",
          "round_type": "series_e",
          "amount_raised": "200000000.00",
          "currency": "USD",
          "valuation": "16000000000.00",
          "announced_date": "2025-06-17",
          "equities": [
            {
              "name": "Series E",
              "equity_type": "preferred",
              "round_type": "series_e",
              "issue_price": "47.5000000",
              "issued_at": "2025-06-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.034948+00:00"
            }
          ],
          "status": "closed",
          "is_extension": false
        }
      },
      {
        "event_id": "st_a7cecea9-634d-494d-bd0a-45779d4099a5",
        "event_type": "secondary_transaction",
        "event_subtype": "tender_offer",
        "event_name": "Tender Offer (2025)",
        "event_date": "2025-03-03",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:12:36.485984+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "a7cecea9-634d-494d-bd0a-45779d4099a5",
          "updated_at": "2025-10-24T01:12:36.485984+00:00",
          "name": "Tender Offer (2025)",
          "transaction_type": "tender_offer",
          "transaction_amount": null,
          "currency": "USD",
          "valuation": "13000000000.00",
          "price_per_share": null,
          "announced_date": "2025-03-03",
          "closing_date": "2025-03-03",
          "created_at": "2025-10-24T01:12:36.478896+00:00",
          "status": "closed"
        }
      },
      {
        "event_id": "fr_2464d613-61d6-4bee-86c7-0ddf84f674b2",
        "event_type": "funding_round",
        "event_subtype": "series_d",
        "event_name": "Series D (2024) Extension",
        "event_date": "2024-04-17",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-27T13:38:31.212436+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "2464d613-61d6-4bee-86c7-0ddf84f674b2",
          "updated_at": "2025-10-27T13:38:31.212436+00:00",
          "name": "Series D (2024) Extension",
          "round_type": "series_d",
          "amount_raised": "150000000.00",
          "currency": "USD",
          "valuation": "7650000000.00",
          "announced_date": "2024-04-17",
          "equities": [
            {
              "name": "Series D",
              "equity_type": "preferred",
              "round_type": "series_d",
              "issue_price": "20.0000000",
              "issued_at": "2024-04-25T19:16:00+00:00",
              "updated_at": "2025-10-24T01:18:05.027279+00:00"
            },
            {
              "name": "Series D-2",
              "equity_type": "preferred",
              "round_type": "series_d",
              "issue_price": "25.0000000",
              "issued_at": "2024-04-25T19:16:00+00:00",
              "updated_at": "2025-10-24T01:18:05.031694+00:00"
            }
          ],
          "status": "closed",
          "is_extension": true
        }
      },
      {
        "event_id": "fr_35405edb-2e8a-4e07-b517-d080e0c832f0",
        "event_type": "funding_round",
        "event_subtype": "series_d",
        "event_name": "Series D (2023)",
        "event_date": "2023-08-22",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:14:33.375472+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "35405edb-2e8a-4e07-b517-d080e0c832f0",
          "updated_at": "2025-10-24T01:14:33.375472+00:00",
          "name": "Series D (2023)",
          "round_type": "series_d",
          "amount_raised": "300000000.00",
          "currency": "USD",
          "valuation": "5800000000.00",
          "announced_date": "2023-08-22",
          "equities": [],
          "status": "closed",
          "is_extension": false
        }
      },
      {
        "event_id": "fr_d3a7773c-e3df-4b9b-8711-8e699213c2b5",
        "event_type": "funding_round",
        "event_subtype": "series_c",
        "event_name": "Growth (2022) Extension",
        "event_date": "2022-03-21",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-27T13:38:26.703499+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "d3a7773c-e3df-4b9b-8711-8e699213c2b5",
          "updated_at": "2025-10-27T13:38:26.703499+00:00",
          "name": "Growth (2022) Extension",
          "round_type": "series_c",
          "amount_raised": "200000000.00",
          "currency": "USD",
          "valuation": "8100000000.00",
          "announced_date": "2022-03-21",
          "equities": [
            {
              "name": "Series C-3",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "30.0000000",
              "issued_at": "2022-03-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:19:34.939585+00:00"
            }
          ],
          "status": "closed",
          "is_extension": true
        }
      },
      {
        "event_id": "fr_362bcaa9-e77d-488b-8562-9aa2ccd4ec70",
        "event_type": "funding_round",
        "event_subtype": "series_c",
        "event_name": "Series C (2021)",
        "event_date": "2021-08-24",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:13:06.683649+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "362bcaa9-e77d-488b-8562-9aa2ccd4ec70",
          "updated_at": "2025-10-24T01:13:06.683649+00:00",
          "name": "Series C (2021)",
          "round_type": "series_c",
          "amount_raised": "300000000.00",
          "currency": "USD",
          "valuation": "3900000000.00",
          "announced_date": "2021-08-24",
          "equities": [
            {
              "name": "Series C-2",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "6.6808000",
              "issued_at": "2021-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.017683+00:00"
            },
            {
              "name": "Series C-1",
              "equity_type": "preferred",
              "round_type": "series_c",
              "issue_price": "15.0000000",
              "issued_at": "2021-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.023665+00:00"
            }
          ],
          "status": "closed",
          "is_extension": false
        }
      },
      {
        "event_id": "fr_c56cfcaa-a00b-4279-8ee2-413114a499d4",
        "event_type": "funding_round",
        "event_subtype": "series_b",
        "event_name": "Series B (2021)",
        "event_date": "2021-04-08",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:12:55.156817+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "c56cfcaa-a00b-4279-8ee2-413114a499d4",
          "updated_at": "2025-10-24T01:12:55.156817+00:00",
          "name": "Series B (2021)",
          "round_type": "series_b",
          "amount_raised": "115000000.00",
          "currency": "USD",
          "valuation": "1600000000.00",
          "announced_date": "2021-04-08",
          "equities": [
            {
              "name": "Series B",
              "equity_type": "preferred",
              "round_type": "series_b",
              "issue_price": "4.7517200",
              "issued_at": "2021-04-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.012209+00:00"
            }
          ],
          "status": "closed",
          "is_extension": false
        }
      },
      {
        "event_id": "fr_6960aea5-9834-4c13-a39c-9e3a6d1b7c7c",
        "event_type": "funding_round",
        "event_subtype": "series_a",
        "event_name": "Series A (2020) Extension",
        "event_date": "2020-08-01",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-27T13:38:20.319450+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "6960aea5-9834-4c13-a39c-9e3a6d1b7c7c",
          "updated_at": "2025-10-27T13:38:20.319450+00:00",
          "name": "Series A (2020) Extension",
          "round_type": "series_a",
          "amount_raised": "30000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2020-08-01",
          "equities": [
            {
              "name": "Series A-4",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.7105800",
              "issued_at": "2020-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.998671+00:00"
            },
            {
              "name": "Series A-3",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "1.0213600",
              "issued_at": "2020-08-31T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:05.008617+00:00"
            }
          ],
          "status": "closed",
          "is_extension": true
        }
      },
      {
        "event_id": "fr_88b1a90e-0a20-4285-9eff-414b45573d4f",
        "event_type": "funding_round",
        "event_subtype": "series_a",
        "event_name": "Series A (2020)",
        "event_date": "2020-02-12",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:14:19.736753+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "88b1a90e-0a20-4285-9eff-414b45573d4f",
          "updated_at": "2025-10-24T01:14:19.736753+00:00",
          "name": "Series A (2020)",
          "round_type": "series_a",
          "amount_raised": "15000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2020-02-12",
          "equities": [
            {
              "name": "Series A-2",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.2561400",
              "issued_at": "2020-01-31T05:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.987879+00:00"
            },
            {
              "name": "Series A-1",
              "equity_type": "preferred",
              "round_type": "series_a",
              "issue_price": "0.5763200",
              "issued_at": "2020-01-31T05:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.993509+00:00"
            }
          ],
          "status": "closed",
          "is_extension": false
        }
      },
      {
        "event_id": "fr_4f656e60-48be-4862-aaff-df62ffb9fa94",
        "event_type": "funding_round",
        "event_subtype": "seed",
        "event_name": "Seed (2019)",
        "event_date": "2019-08-01",
        "event_status": "closed",
        "event_last_updated_at": "2025-10-24T01:13:18.484702+00:00",
        "company": { "id": "65", "slug": "ramp", "domain": "ramp.com" },
        "data": {
          "id": "4f656e60-48be-4862-aaff-df62ffb9fa94",
          "updated_at": "2025-10-24T01:13:18.484702+00:00",
          "name": "Seed (2019)",
          "round_type": "seed",
          "amount_raised": "8000000.00",
          "currency": "USD",
          "valuation": null,
          "announced_date": "2019-08-01",
          "equities": [
            {
              "name": "Series Seed",
              "equity_type": "preferred",
              "round_type": "seed",
              "issue_price": "0.2105000",
              "issued_at": "2019-06-30T04:00:00+00:00",
              "updated_at": "2025-10-24T01:18:04.982651+00:00"
            }
          ],
          "status": "closed",
          "is_extension": false
        }
      }
    ],
    "pagination": {
      "page": 1,
      "page_size": 30,
      "total_pages": 1,
      "total_count": 11,
      "has_next": false,
      "has_previous": false
    }
  }
  ```
</Accordion>