---
title: "List your events"
method: GET
path: "/api/v1/events"
tags: ["Events"]
---

# List your events

`GET /api/v1/events`

## Request

- Base URL: `https://www.venumark.com`
- URL: `https://www.venumark.com/api/v1/events`
- Auth: HTTP bearer

Unpaginated; returns every event the authenticated account owns.

## Query parameters

- `status` 'Published' | 'Draft' | 'Completed' | 'Cancelled'

## Response `200`

List of events owned by the authenticated account.

- EventListEnvelope
  - `data` Event[], required
  - `meta` EnvelopeMeta, nullable: Optional response metadata, e.g. {count}. List endpoints are unpaginated and return the full result set. Null when not applicable.
  - `error` unknown, required

## Other responses

- `401`: Missing, malformed, invalid, or revoked API key.
- `429`: Rate limit exceeded (60 requests per minute per key).

---

[API](https://skmtc.dev/venumark/apis/venumark-read-api.md) · [All operations](https://skmtc.dev/venumark/apis/venumark-read-api/llms.txt) · [OpenAPI document](https://skmtc.dev/venumark/apis/venumark-read-api/revisions/3bd019092f9c?raw)