---
title: "Get all events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# Get all events

`GET /v1/events`

Fetches all usage events, and can be filtered as needed. Reach out to your account manager if you would like to participate in the Beta for the new Usage API.

## Query parameters

- `startDate` string
- `endDate` string
- `ingestStartDate` string
- `ingestEndDate` string
- `customerId` string
- `eventTypeId` string
- `source` string
- `limit` integer
- `cursor` string
- `orderDirection` string
- `skipDeletionEvents` boolean

## Response `200`

Events retrieved successfully

- EventsQueryResponse — Response containing a list of events with pagination information
  - `events` EventDto[] — List of events
    - `manufacturerId` string
    - `eventTypeId` string
    - `metadata` object
    - `value` string
    - `differentiator` string
    - `invoiceGroup` string
    - `idempotencyKey` string
    - `datetime` string
    - `customerId` string
    - `parentEventId` string
    - `source` string
    - `deleted` boolean — Whether the event is deleted
  - `count` integer — Total count of events
  - `nextCursor` string — Cursor for the next page of results
  - `hasMore` boolean — Whether there are more results available

## Other responses

- `400` — Bad request - Invalid parameters
- `429` — Too Many Requests - Rate limit exceeded
- `500` — Internal server error - Failed to retrieve events

---

[API](https://skmtc.net/tabsplatform/apis/tabs-external-api.md) · [All operations](https://skmtc.net/tabsplatform/apis/tabs-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tabsplatform/tabs-external-api/revisions/7e8885517814/schema)