---
title: "Search venues"
method: GET
path: "/venues"
tags: ["Venues"]
---

# Search venues

`GET /venues`

## Request

- Base URL: `https://wall.marketing/api/v1`
- URL: `https://wall.marketing/api/v1/venues`
- Auth: one of:
  - none
  - HTTP bearer

Find Wall Marketing screens: small e-paper screens at eye level on the inside of venue doors (bars, cafes, hostels, gyms, coworking spaces). Each screen shows one advert at a time, so a booking has the screen to itself. Filter by city or address text, venue type, price, distance from a point, and free dates. Prices are per screen per day in US dollars. Works without a key (live network; add ?sandbox for made-up venues).

## Query parameters

- `city` string
- `venue_type` 'bar' | 'cafe' | 'restaurant' | 'hostel' | 'hotel' | 'gym' | 'coworking' | 'office' | 'campus' | 'event_venue' | 'retail' | 'other'
- `max_price_per_day_usd` number
- `near` string
- `radius_km` number
- `available_from` string, date
- `available_to` string, date
- `limit` integer

## Response `200`

OK

- object
  - `object` 'list'
  - `data` Venue[]
    - `object` string: Always "venue".
    - `id` string: The venue_id to quote and book with.
    - `name` string: The venue's name.
    - `address` string, nullable: Street address.
    - `latitude` number, nullable: Latitude of the venue.
    - `longitude` number, nullable: Longitude of the venue.
    - `venue_type` string, nullable: Kind of venue: bar, cafe, restaurant, hostel, hotel, gym, coworking, office, campus, event_venue, retail, other.
    - `price_per_day_usd` number: Price for one day on this screen, in US dollars.
    - `estimated_views_per_day` number, nullable: Estimated people passing the screen each day; an estimate, not a measurement.
    - `opening_hours` string[], nullable: Opening hours, one line per day, when known.
    - `online` boolean: Whether the screen checked in within the last 26 hours.
    - `last_seen_at` string, nullable: When the screen last checked in. ISO 8601, UTC.
    - `earliest_start` string: The first start_date a new booking can have here: the screen shows a new advert from the venue's next local midnight.
    - `distance_km` number: Distance from near_latitude/near_longitude, when searching near a point.
    - `booked` object[]: Date ranges already booked (advertiser.venues.get only).
      - `start_date` string: Booked from.
      - `end_date` string: Booked until (exclusive).
    - `screen` object: The screen at the venue.
      - `technology` string: Display technology (e-paper).
      - `size_inches` number: Screen diagonal in inches.
      - `width_px` integer: Width in pixels.
      - `height_px` integer: Height in pixels.
      - `colours` string[]: The colours the panel can show.
      - `placement` string: Where the screen hangs.
      - `exclusive` boolean: True: one advert per screen at a time.
  - `has_more` boolean

## Other responses

- `400`: Error
- `401`: Error
- `403`: Error
- `404`: Error
- `409`: Error
- `429`: Error

---

[API](https://skmtc.dev/wall/apis/wall-marketing-platform-api.md) · [All operations](https://skmtc.dev/wall/apis/wall-marketing-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wall/apis/wall-marketing-platform-api/revisions/290b284951e3?raw)