# List events

Events newest first, filtered by type, date, organisation, industry, or a saved search.

Canonical: https://chikaraintel.com/docs/api/reference/events/list-events

```text
GET https://api.chikaraintel.com/v1/events
```

Authentication: `Authorization: Bearer <token>`.

## Parameters

- `eventType` (string, query) Restrict to one event type. Values: `move`, `funding`, `public_offering`, `merger_and_acquisition`, `client_summary`, `relationship_change`.
- `publishedDate` (date, query) Published on this date, `YYYY-MM-DD`.
- `publishedDateFrom` (date, query) Published on or after this date.
- `publishedDateTo` (date, query) Published on or before this date.
- `organisationReference` (uuid, query) Events involving this organisation in any role: employer on a move, recipient of funding, either side of a deal.
- `industryCode` (string, query) A GICS code prefix. Applies to moves.
- `queryId` (uuid, query) Apply a saved search from [POST /v1/search/events](/docs/api/reference/search/create-event-search).
- `dealStatus` (string, query) Deals only, with `eventType=merger_and_acquisition`. One of the [deal statuses](/docs/concepts/deals).
- `dealType` (string, query) Deals only. One of the [deal types](/docs/concepts/deals).
- `jurisdiction` (string, query) Deals only. A two-letter jurisdiction code.
- `dealValueMin` (number, query) Deals only. Minimum deal value in USD.
- `dealValueMax` (number, query) Deals only. Maximum deal value in USD.
- `page` (integer, query) 1-based page number. Default `1`.
- `limit` (integer, query) Rows per page, up to 200. A larger value is capped at 200, not rejected. Default `20`.

## Response

The payload is under `success`, with paging details under `meta`.

- `reference` (uuid) The event's reference.
- `event_type` (string) See [event types](/docs/concepts/events).
- `summary` (string | null) A readable one-line summary.
- `publish_date` (datetime) When the event became public.
- `data` (object) Fields for this event type.
  - `move_type` (string) Moves. One of the [move types](/docs/concepts/moves).
  - `profile` (object) Moves. `{ reference, first_name, last_name }`.
  - `occupation` (object | null) Moves. `{ reference, name }`.
  - `organisation` (object) `{ reference, name }` and, on moves, listings and addresses.
  - `effective_date` (datetime) Moves. When the move takes effect.
  - `compensations` (array) Moves. `{ type, value, value_type, value_suffix }` per component.
  - `articles` (array) Moves. Source articles with their annotations.
  - `round` (string) Funding. The round, such as `SeriesB`.
  - `value` (number) Funding. The amount raised, with `currency_code`.
  - `acquirer` (object) Deals. `{ reference, name }`.
  - `acquiree` (object) Deals. `{ reference, name }`.
  - `deal` (object) Deals. `type`, `status`, `value`, `value_usd`, `announcement_date`, `completion_date` and terms.
  - `entries` (array) AUM records. One row per client type.
- `links` (object | array) Related links. Empty on most types.

> **Stop on a short page** On broad filters `meta.total` can be an estimate for the whole table. Stop paging when a page returns fewer rows than `limit`. See [pagination](/docs/api/pagination).

Invalid dates currently return a 500 rather than a validation message. Send dates as `YYYY-MM-DD`.

## Examples

cURL:

```bash
curl -sS -G "https://api.chikaraintel.com/v1/events" \
  -H "Authorization: Bearer $CHIKARA_API_TOKEN" \
  -H "Accept: application/json" \
  --data-urlencode "eventType=move" \
  --data-urlencode "publishedDateFrom=2026-08-01" \
  --data-urlencode "publishedDateTo=2026-08-31" \
  --data-urlencode "limit=50" \
  --data-urlencode "page=1"
```

JavaScript:

```javascript
const BASE = "https://api.chikaraintel.com";
const headers = {
  Authorization: `Bearer ${process.env.CHIKARA_API_TOKEN}`,
  Accept: "application/json"
};

const limit = 50;
const maxPages = 20; // hard cap
const rows = [];

for (let page = 1; page <= maxPages; page++) {
  const params = new URLSearchParams({
    eventType: "move",
    publishedDateFrom: "2026-08-01",
    publishedDateTo: "2026-08-31",
    limit: String(limit),
    page: String(page)
  });
  const res = await fetch(`${BASE}/v1/events?${params}`, { headers });
  if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);

  const { success } = await res.json();
  rows.push(...success);
  if (success.length < limit) break; // a short page is the last page
}

console.log(rows.length, rows[0]);
```

Python:

```python
import os
import requests

BASE = "https://api.chikaraintel.com"
HEADERS = {
    "Authorization": f"Bearer {os.environ['CHIKARA_API_TOKEN']}",
    "Accept": "application/json",
}

LIMIT = 50
MAX_PAGES = 20  # hard cap
rows = []

for page in range(1, MAX_PAGES + 1):
    res = requests.get(
        f"{BASE}/v1/events",
        headers=HEADERS,
        params={
            "eventType": "move",
            "publishedDateFrom": "2026-08-01",
            "publishedDateTo": "2026-08-31",
            "limit": LIMIT,
            "page": page,
        },
        timeout=30,
    )
    res.raise_for_status()
    batch = res.json()["success"]
    rows.extend(batch)
    if len(batch) < LIMIT:  # a short page is the last page
        break

print(len(rows), rows[:1])
```

Response:

```json
{
  "status": {
    "code": 200,
    "messages": []
  },
  "success": [
    {
      "reference": "e5f6a7b8-c9d0-4e1f-8a3b-c4d5e6f7a881",
      "event_type": "move",
      "summary": "Halberd Industrial Group appoints Elena Marchetti as Chief Financial Officer",
      "publish_date": "2026-08-04T07:00:00+00:00",
      "data": {
        "move_type": "Appointment",
        "effective_date": "2026-09-01T00:00:00+00:00",
        "profile": {
          "reference": "a1b2c3d4-e5f6-4a7b-9c8d-e9f0a1b2c341",
          "first_name": "Elena",
          "last_name": "Marchetti"
        },
        "occupation": {
          "reference": "7d0e1f2a-b4c5-4d6e-9f8a-b9c0d1e2f3d1",
          "name": "Chief Financial Officer"
        },
        "organisation": {
          "reference": "3f2a9c1e-7b4d-4e8a-9c21-5d6e7f8a9b01",
          "name": "Halberd Industrial Group"
        },
        "compensations": [
          {
            "type": "Base salary",
            "value": "520000",
            "value_type": "Amount",
            "value_suffix": "GBP"
          }
        ],
        "articles": [
          {
            "reference": "8e1f2a3b-c5d6-4e7f-8a9b-c0d1e2f3a4e1",
            "title": "Appointment of Chief Financial Officer",
            "published_at": "2026-08-04T07:00:00+00:00",
            "annotations": []
          }
        ]
      },
      "links": []
    }
  ],
  "meta": {
    "total": 1,
    "rows_per_page": 50,
    "page": 1,
    "total_pages": 1,
    "links": {
      "first-page": {
        "href": "/v1/events?page=1",
        "method": "GET"
      },
      "current-page": {
        "href": "/v1/events?page=1",
        "method": "GET"
      }
    }
  },
  "correlation_id": "5f0c2a9e4b7d4c1e"
}
```

## Used by

- get_company_aum_history
- search_events