---
title: "List event slugs"
method: GET
path: "/events/slugs"
tags: ["Events"]
---

# List event slugs

`GET /events/slugs`

List current event slugs with the same filters and access rules as event lists. Supports skip/limit pagination for sitemap generation.

## Query parameters

- `status` 'UPCOMING' | 'ENDED' — Filter events by their current lifecycle status
- `approval` 'PENDING' | 'APPROVED' | 'REJECTED' — Filter events by their approval status
- `visibility` 'PUBLIC' | 'PRIVATE' | 'SCHEDULED' | 'PASSCODE' — Filter events by their visibility setting
- `promoterId` string — Filter events to only those belonging to a specific promoter. If not provided, returns events from all promoters the user has access to
- `teamId` string — Filter events to only those belonging to a specific team. If not provided, returns events from all teams the user has access to
- `venueId` string — Filter events to only those at a specific venue. If not provided, returns events at all venues
- `query` string — Search term to filter events by name, description, or location. Triggers full‑text search when provided
- `latitude` number — Latitude coordinate for geographic search. Provide with longitude (and optional radius)
- `longitude` number — Longitude coordinate for geographic search. Provide with latitude (and optional radius)
- `radius` number — Search radius in kilometers from the provided coordinates. Defaults to 20km
- `country` string — Filter by country region slug. Matches events where location.country equals the region name
- `state` string — Filter by state/province region slug. Matches events where location.state equals the region name
- `city` string — Filter by city region slug. Matches events where location.city equals the region name
- `from` string, date — Filter events that start on or after this date (YYYY-MM-DD format). Events with entryStartsAt >= from
- `to` string, date — Filter events that start on or before this date (YYYY-MM-DD format). Events with entryStartsAt <= to
- `sort` 'entryStartsAt' | 'createdAt' — Optional list sort field. Defaults to event start time. Use `createdAt` to return newest or oldest events first.
- `direction` 'asc' | 'desc' — Sort direction for event lists. Defaults to lifecycle-aware event start order unless `sort` is provided.
- `genres` string[] — Filter events by music genre(s). Returns events matching ANY of the provided genres (OR logic). Maximum 20 genres
- `categories` string[] — Filter events by category(s). Returns events matching ANY of the provided categories (OR logic). Maximum 10 categories
- `featured` boolean — Filter to only featured (editorial pick) events
- `limit` integer — Maximum number of event slugs to return. Must be between 1 and 1000, defaults to 1000
- `skip` integer — Number of matching event slugs to skip before returning results

## Response `200`

OK

- object
  - `slugs` string[], required — Current event slugs for the matching event list
  - `skip` integer, required — Number of matching event slugs skipped
  - `limit` integer, required — Maximum number of event slugs returned

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `409` — 409
- `412` — 412
- `422` — 422
- `429` — 429
- `500` — 500
- `501` — 501
- `503` — 503

---

[API](https://skmtc.net/session/apis/session-services-api.md) · [All operations](https://skmtc.net/session/apis/session-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/session/session-services-api/versions/bec3de84da9e/schema)