---
title: "Venue details"
method: GET
path: "/venues/{venue_id}"
tags: ["Venues"]
---

# Venue details

`GET /venues/{venue_id}`

## Request

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

One venue's details, price and the date ranges it is already booked (end dates exclusive).

## Path parameters

- `venue_id` string, required

## Response `200`

OK

- 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.

## 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)