---
title: "GET /api/feed/v1/venues/{venueId}/schedule"
method: GET
path: "/api/feed/v1/venues/{venueId}/schedule"
tags: ["Feed"]
---

# GET /api/feed/v1/venues/{venueId}/schedule

`GET /api/feed/v1/venues/{venueId}/schedule`

## Request

- Base URL: `https://api.findticker.com`
- URL: `https://api.findticker.com/api/feed/v1/venues/{venueId}/schedule`
- Auth: HTTP bearer

## Path parameters

- `venueId` string, required

## Query parameters

- `days` integer: How far forward to look, in days. Default 30, maximum 365.
- `limit` integer: Most events to return. Default and cap 200: a larger value returns at most 200, never an error. Each one costs a unit, so a narrow window costs less than a wide one.

## Response `200`

A venue's identity and everything on there inside a forward window, soonest first. Default 30 days, `days` widens it to 365. Rows are the same projection the public venue page renders: name, date, sale dates and the get-in price. The venue carries its roof, and `forecast` lists the stored weather for each of its next 7 local days, today first. Costs one unit per event returned.

- FeedVenueSchedule
  - `venue` FeedVenueIdentity, required
    - `venue_id` string, nullable, required
    - `venue_name` string, nullable, required
    - `city` string, nullable, required
    - `state` string, nullable, required
    - `roof` 'open' | 'retractable' | 'fixed', nullable, required: The venue's roof: open, retractable or fixed. Null while the roof is not known.
  - `window` object, required
    - `days` integer, required
    - `from` string, required
    - `to` string, required
  - `events` FeedVenueScheduleEvent[], required
    - `event_id` string, required
    - `event_name` string, nullable, required
    - `local_date` string, nullable, required
    - `date_tbd` boolean, nullable, required
    - `onsale_date` string, nullable, required
    - `presale1_date` string, nullable, required
    - `lowest_price_current` number, nullable, required: The VS get-in before fees, in dollars.
    - `lowest_aip_price_current` number, nullable, required: The VS get-in with all fees (the all-in price), in dollars. Null where the row has none; never worked out from the price before fees.
    - `last_price_snapshot_date` string, nullable, required
  - `has_more` boolean, required
  - `forecast` VenueForecastDay[], required: The latest stored forecast reading for each of the venue's next 7 local days, today first. A day with no reading is left out; an empty list means no reading covers the week.
    - `date` string, required: The venue's local calendar day, YYYY-MM-DD.
    - `taken_at` string, required: When the forecast reading was taken, ISO 8601 UTC.
    - `temp_max_f` integer
    - `temp_min_f` integer
    - `kind` 'clear' | 'cloudy' | 'fog' | 'rain' | 'snow' | 'storm'
    - `label` string
    - `rain_chance` integer: Highest chance of rain over the day, percent.
    - `rain_in` number: Total rain over the day, inches.
    - `wind_mph` integer: Highest sustained wind over the day, mph.
    - `gust_mph` integer: Highest gust over the day, mph.

## Other responses

- `400`: Validation error, an unknown `columns` name (the message lists the valid set), or a batch over the size bound.
- `401`: Missing or invalid API key.
- `403`: The key's account is not entitled to the feed, or the account or the address it calls from is blocked (`reason` `blocked`).
- `404`: No such venue.
- `429`: The per-minute burst ceiling or the unit budget for the current UTC date is used up.
- `500`: Internal Server Error.

---

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