---
title: "Retrieve the history of events within a specific namespace."
method: GET
path: "/api/v2/namespaces/{namespace}/events/history"
tags: ["events"]
---

# Retrieve the history of events within a specific namespace.

`GET /api/v2/namespaces/{namespace}/events/history`

This endpoint allows you to retrieve the history of events within the specified namespace. You can filter events based on various criteria such as creation time, reception time, event type, and text contained in the event.

## Path parameters

- `namespace` string, required

## Query parameters

- `before` string, RFC3339Nano
- `createdBefore` string, RFC3339Nano
- `createdAfter` string, RFC3339Nano
- `receivedBefore` string, RFC3339Nano
- `receivedAfter` string, RFC3339Nano
- `eventContains` string
- `typeContains` string

## Response `200`

OK

- object
  - `meta` object, nullable
    - `previousPage` string, RFC3339Nano
    - `startingFrom` string, RFC3339Nano
  - `data` object[]
    - `namespace` string
    - `namespaceID` string
    - `receivedAt` string, RFC3339Nano
    - `serialID` number
    - `event` object
      - `specversion` string, required
      - `id` string, required
      - `source` string, uri, required
      - `type` string, required
      - `additionalProperties` object

## Changes

- **2025-11-11** `cadb41a89182` — 1 breaking
  - the `data/items/serialID` response's property type changed from `int` to `number` for status `200`
- **2025-11-11** `5ca26983939a` — 3 breaking
  - the response property `meta` became nullable for the status `200`
  - the response property `meta/previousPage` became nullable for the status `200`
  - the `data/items/serialID` response's property type changed from `number` to `int` for status `200`

[Change history](https://skmtc.dev/direktiv/apis/direktiv-apiv2-reference/changes/api/v2/namespaces/:namespace/events/history/get.md)

---

[API](https://skmtc.dev/direktiv/apis/direktiv-apiv2-reference.md) · [All operations](https://skmtc.dev/direktiv/apis/direktiv-apiv2-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/direktiv/apis/direktiv-apiv2-reference/revisions/ad935afb0f54?raw)