Events - Liveday Developers

Events are the core resource of the Liveday platform. Each event represents a scheduled happening at a venue.

List events

GET /v1/events

Returns a paginated list of events.

Query parameters

Parameter	Type	Description
`page`	integer	Page number (default: 1)
`per_page`	integer	Items per page (default: 25, max: 100)
`status`	string	Filter by status: `draft`, `published`, `cancelled`
`venue_id`	string	Filter by venue

Response

{
  "data": [
    {
      "id": "evt_abc123",
      "name": "Summer Festival 2026",
      "description": "Annual summer music festival",
      "status": "published",
      "starts_at": "2026-06-15T18:00:00Z",
      "ends_at": "2026-06-15T23:00:00Z",
      "venue": {
        "id": "ven_xyz789",
        "name": "Stockholm Arena"
      },
      "created_at": "2026-01-10T12:00:00Z",
      "updated_at": "2026-01-10T12:00:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 42
  }
}

Get an event

GET /v1/events/:id

Returns a single event by ID.

Create an event

POST /v1/events

Request body

{
  "name": "Summer Festival 2026",
  "description": "Annual summer music festival",
  "starts_at": "2026-06-15T18:00:00Z",
  "ends_at": "2026-06-15T23:00:00Z",
  "venue_id": "ven_xyz789"
}

Update an event

PATCH /v1/events/:id

Delete an event

DELETE /v1/events/:id

Deleting events

Deleting an event will also cancel all associated tickets and trigger refunds for any paid orders. This action cannot be undone.