Get Venue RouteBook

Fetch a list of upcoming events (the routebook) for a specific venue.

Endpoint

https://www.pollstar.com/api/v2/venues/{venueId}/routebook/

Parameters

venueId
The id of the venue.
fromDate
[optional] The starting date for the range of events to select. If this parameter is omitted, the selected event range will start from the current date. If the supplied fromDate is earlier than the current date, it will be ignored and events will be selected using the current date as the starting point. The date format should be in US format, MM/DD/YYYY.
toDate
[optional] The end date for the range of events to select. If this parameter is omitted, the selected event range will have no effective end date, and all future events will be selected with respect to the page and pageSize parameters. If the fromDate is later than toDate, the date range selection will always operate on the assumption that the earliest date is first start date and the later date is the end date.  The date format should be in US format, MM/DD/YYYY.
page
[optional] The zero-based index of the page number to select. Selecting a page number that is higher than the number of available pages will succeed with an empty response.
pageSize
[optional] The size of each page. Using a combination of the page and pageSize parameters, you can create a custom paging solution.

Remarks

It is also possible to implement a paging system based on the fromDate and toDate parameters, instead of using page and pageSize by requesting data in date range blocks (by month or year for example).

Example

To fetch the 2nd page of upcoming events for the venue with an id of 275273, with 3 events per page:

https://www.pollstar.com/api/v2/venues/275273/routebook/?page=1&pageSize=3

Response

{
    "page": 1,
    "pageSize": 3,
    "totalPages": 5,
    "totalEvents": 13,
    "fromDate": null,
    "toDate": null,
    "events": [
        {
            "EventId": 0,
            "EventName": "Love Vigilantes",
            "EventUrl": "https://localhost:2431/event/love-vigilantes-7365995",
            "VenueId": 275273,
            "VenueName": "Fulton 55",
            "VenueUrl": "https://localhost:2431/venue/fulton-55-275273",
            "CityId": 23546,
            "CityName": "Fresno",
            "CityUrl": "https://localhost:2431/city/fresno-23546",
            "State": "CA",
            "Country": "United States",
            "Region": "Fresno, CA",
            "HasEventTickets": true,
            "PlayDate": "4/28/2018",
            "HoursOld": 1490,
            "IsFestival": false,
            "Support": "Erasure-Esque, She's Lost Control"
        },
        {
            "EventId": 0,
            "EventName": "Blake Jones",
            "EventUrl": "https://localhost:2431/event/blake-jones-7396838",
            "VenueId": 275273,
            "VenueName": "Fulton 55",
            "VenueUrl": "https://localhost:2431/venue/fulton-55-275273",
            "CityId": 23546,
            "CityName": "Fresno",
            "CityUrl": "https://localhost:2431/city/fresno-23546",
            "State": "CA",
            "Country": "United States",
            "Region": "Fresno, CA",
            "HasEventTickets": true,
            "PlayDate": "5/6/2018",
            "HoursOld": 598,
            "IsFestival": false,
            "Support": null
        },
        {
            "EventId": 0,
            "EventName": "Los Kung Fu Monkeys",
            "EventUrl": "https://localhost:2431/event/los-kung-fu-monkeys-7365996",
            "VenueId": 275273,
            "VenueName": "Fulton 55",
            "VenueUrl": "https://localhost:2431/venue/fulton-55-275273",
            "CityId": 23546,
            "CityName": "Fresno",
            "CityUrl": "https://localhost:2431/city/fresno-23546",
            "State": "CA",
            "Country": "United States",
            "Region": "Fresno, CA",
            "HasEventTickets": true,
            "PlayDate": "5/17/2018",
            "HoursOld": 598,
            "IsFestival": false,
            "Support": "Basura, For The Record"
        }
    ]
}
<root>
    <page>1</page>
    <pageSize>3</pageSize>
    <totalPages>5</totalPages>
    <totalEvents>13</totalEvents>
    <fromDate />
    <toDate />
    <events>
        <event>
            <EventId>0</EventId>
            <EventName>Love Vigilantes</EventName>
            <EventUrl>https://localhost:2431/event/love-vigilantes-7365995</EventUrl>
            <VenueId>275273</VenueId>
            <VenueName>Fulton 55</VenueName>
            <VenueUrl>https://localhost:2431/venue/fulton-55-275273</VenueUrl>
            <CityId>23546</CityId>
            <CityName>Fresno</CityName>
            <CityUrl>https://localhost:2431/city/fresno-23546</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Fresno, CA</Region>
            <HasEventTickets>true</HasEventTickets>
            <PlayDate>4/28/2018</PlayDate>
            <HoursOld>1490</HoursOld>
            <IsFestival>false</IsFestival>
            <Support>Erasure-Esque, She's Lost Control</Support>
        </event>
        <event>
            <EventId>0</EventId>
            <EventName>Blake Jones</EventName>
            <EventUrl>https://localhost:2431/event/blake-jones-7396838</EventUrl>
            <VenueId>275273</VenueId>
            <VenueName>Fulton 55</VenueName>
            <VenueUrl>https://localhost:2431/venue/fulton-55-275273</VenueUrl>
            <CityId>23546</CityId>
            <CityName>Fresno</CityName>
            <CityUrl>https://localhost:2431/city/fresno-23546</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Fresno, CA</Region>
            <HasEventTickets>true</HasEventTickets>
            <PlayDate>5/6/2018</PlayDate>
            <HoursOld>598</HoursOld>
            <IsFestival>false</IsFestival>
            <Support />
        </event>
        <event>
            <EventId>0</EventId>
            <EventName>Los Kung Fu Monkeys</EventName>
            <EventUrl>https://localhost:2431/event/los-kung-fu-monkeys-7365996</EventUrl>
            <VenueId>275273</VenueId>
            <VenueName>Fulton 55</VenueName>
            <VenueUrl>https://localhost:2431/venue/fulton-55-275273</VenueUrl>
            <CityId>23546</CityId>
            <CityName>Fresno</CityName>
            <CityUrl>https://localhost:2431/city/fresno-23546</CityUrl>
            <State>CA</State>
            <Country>United States</Country>
            <Region>Fresno, CA</Region>
            <HasEventTickets>true</HasEventTickets>
            <PlayDate>5/17/2018</PlayDate>
            <HoursOld>598</HoursOld>
            <IsFestival>false</IsFestival>
            <Support>Basura, For The Record</Support>
        </event>
    </events>
</root>

 

%d bloggers like this: