---
title: GET /v1/events
description: List every event category slug you can pass to the news endpoint's event_type filter.
sidebar:
  label: Events
  order: 1
---

Lists the valid event categories — the values you can pass to [`/v1/news`](/docs/reference/news)'s `event_type` filter.

## Request

```
GET /v1/events
Authorization: Bearer <key>
```

No query parameters or body.

```bash
curl https://newsapi.insighthread.com/api/v1/events \
  -H "Authorization: Bearer ik_test_xxxxxxxxxxxxxxxx"
```

## Response

`200 OK`

```json
{
  "count": 6,
  "data": [
    { "event_type": "Corporate Earnings", "slug": "corporate-earnings" },
    { "event_type": "Mergers and Acquisitions", "slug": "mergers-and-acquisitions" },
    { "event_type": "New Projects/Ventures", "slug": "new-projects-ventures" },
    { "event_type": "Legal Action", "slug": "legal-action" },
    { "event_type": "Drug Updates", "slug": "drug-updates" }
  ]
}
```

| Field | Type | Description |
| --- | --- | --- |
| `count` | number | Number of event categories returned. |
| `data[].event_type` | string | Human-readable category label. |
| `data[].slug` | string | The value to pass as `event_type` on [`/v1/news`](/docs/reference/news). |

:::tip
`/v1/news` also accepts the raw label (e.g. `Legal Action`) for `event_type`, but the slug (`legal-action`) is the stable value to build against — labels can be renamed, slugs derive deterministically from them.
:::