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

---

[API](https://skmtc.net/direktiv/apis/direktiv-apiv2-reference.md) · [All operations](https://skmtc.net/direktiv/apis/direktiv-apiv2-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/direktiv/direktiv-apiv2-reference/revisions/ad935afb0f54/schema)