# GET /v2/events/kinds

**List event kinds**

Returns every event kind: what it is, whether it is in the default stream and can be subscribed to, what its `ts` means, and the fields you can name in `q`, `select` and `group_by` when you ask for that kind alone.

## Returns

- `as_of` (string) — Server time this response was assembled (ISO 8601); on an as-of read, the instant you asked for ([As-of](/docs/asof)).
- `count` (number) — The kinds in `kinds`.
- `common_fields` (array) — The fields every event has, whatever its kind: `id` (stable across reads; use it to drop duplicates), `ticker`, `ts`, `kind`. Each as `name`, `type`, `description`, `nullable`.
- `kinds` (array) — One entry per kind.
  - `kind` (string) — The value `kind` takes on [Query events](/docs/endpoints/events/query) and [Subscribe to events](/docs/endpoints/events/subscribe).
  - `label` (string) — A display name.
  - `description` (string) — What one event of this kind is.
  - `default` (boolean) — `true` when Query events returns it with `kind` left out.
  - `subscribable` (boolean) — `true` when Subscribe to events takes it.
  - `ts` (string) — What `ts` means for this kind.
  - `id_rule` (string) — What the key in this kind's `id` is made of.
  - `history_start` (string) — The earliest `ts` stored (`YYYY-MM-DD`). `null` for `signal`: each signal's history starts on its own date at each grain, given by [List signals](/docs/endpoints/signals/list) as `grains.<grain>.since`.
  - `fields` (array) — The payload fields, each `name`, `type` (`number`, `string`, `date`, `timestamp`), `description` and `nullable`, plus `values` on a field that takes a fixed set: one `value` and `description` per value, such as each Form 4 code on `insider` `action`. With this kind alone they are bare names in `q`, `select` and `group_by`.
  - `filters` (array) — Parameters that apply with this kind only, each `name` and `description`, plus `deprecated: true` on those that stop on 2027-01-12.

## Status codes

- **200** — Success: the response shape is documented under Returns above. Cacheable for an hour.

## Sample response

```json
{
  "as_of": "2026-11-11T15:00:00.000Z",
  "count": 9,
  "common_fields": [
    { "name": "id", "type": "string", "nullable": false, "description": "The event's stable id, `<kind>:<key>`. Stable across reads; use it to drop duplicates. …" },
    "… (ticker, ts, kind)"
  ],
  "kinds": [
    { "kind": "earnings", "label": "Earnings", "description": "Quarterly earnings reports: reported vs estimated EPS and the surprise.",
      "default": true, "subscribable": true,
      "ts": "The report date (midnight UTC). `available_at` is when the market could first trade on it.",
      "id_rule": "ticker|reported date, e.g. …",
      "history_start": "…", "filters": [],
      "fields": [
        { "name": "fiscal_period_end", "type": "date", "description": "Last day of the fiscal quarter the report covers.", "nullable": false },
        "… (one entry per payload field)"
      ] },
    "… (dividend, split, filing, insider, analyst, estimate_revision, news, signal)"
  ]
}
```

## Notes

- The same fields are listed under `payload` on [Query events](/docs/endpoints/events/query); both come from one source.

---

Interactive sandbox + parameter editor: https://tickerbot.io/docs/endpoints/events/kinds
