---
title: "List / filter venues"
method: GET
path: "/api/v1/venues"
tags: ["venues"]
---

# List / filter venues

`GET /api/v1/venues`

## Request

- Base URL: `https://api.vikenda.com`
- URL: `https://api.vikenda.com/api/v1/venues`
- Auth: none declared

## Query parameters

- `q` string
- `category` string
- `limit` integer
- `cursor` string
- `area` string

## Response `200`

Venues.

- object
  - `data` Venue[], required
    - `id` string, required
    - `name` string, required
    - `category` string, nullable, required
    - `lat` number, nullable, required
    - `lon` number, nullable, required
    - `address` string, nullable, required
    - `contact` unknown
    - `website_url` string, nullable, required
    - `website_domain` string, nullable, required
    - `hours` unknown
    - `booking_platform` string, nullable, required
    - `partner_tier` string, required
    - `weather_exposure` string, nullable, required: indoor | outdoor | mixed | null (unknown).
    - `url` string, required
  - `meta` Meta, required: Attribution + pagination envelope metadata (present on every response).
    - `source` 'Vikenda', required
    - `canonical_url` string, required
    - `generated_at` string, required
    - `area` string, required
    - `count` number
    - `next_cursor` string, nullable

---

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