Get Artist RouteBook

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

Endpoint

https://www.pollstar.com/api/v2/artists/{artistId}/routebook/

Parameters

artistId
The id of the artist.
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 list of upcoming events for the artist with an id of 13157, for the month of April, 2018:

https://www.pollstar.com/api/v2/artists/13157/routebook/?fromDate=4/1/2018&toDate=5/1/2018

Response

{
    "page": 0,
    "pageSize": 0,
    "totalPages": 1,
    "totalEvents": 3,
    "fromDate": "4/1/2018",
    "toDate": "5/1/2018",
    "events": [
        {
            "EventId": 10310460,
            "EventName": "Reverend Horton Heat",
            "EventUrl": "https://localhost:2431/event/reverend-horton-heat-6009336",
            "VenueId": 109117546,
            "VenueName": "Growlers",
            "VenueUrl": "https://localhost:2431/venue/growlers-109117546",
            "CityId": 37224,
            "CityName": "Memphis",
            "CityUrl": "https://localhost:2431/city/memphis-37224",
            "State": "TN",
            "Country": "United States",
            "Region": "Memphis, TN",
            "HasEventTickets": true,
            "PlayDate": "4/5/2018",
            "HoursOld": 4196,
            "IsFestival": false,
            "Support": "Unknown Hinson"
        },
        {
            "EventId": 10310439,
            "EventName": "Reverend Horton Heat",
            "EventUrl": "https://localhost:2431/event/reverend-horton-heat-6009325",
            "VenueId": 267942,
            "VenueName": "George's Majestic Lounge",
            "VenueUrl": "https://localhost:2431/venue/georges-majestic-lounge-267942",
            "CityId": 22025,
            "CityName": "Fayetteville",
            "CityUrl": "https://localhost:2431/city/fayetteville-22025",
            "State": "AR",
            "Country": "United States",
            "Region": "Fayetteville, AR",
            "HasEventTickets": true,
            "PlayDate": "4/6/2018",
            "HoursOld": 4196,
            "IsFestival": false,
            "Support": "Unknown Hinson"
        },
        {
            "EventId": 10310558,
            "EventName": "Reverend Horton Heat",
            "EventUrl": "https://localhost:2431/event/reverend-horton-heat-6009312",
            "VenueId": 276525,
            "VenueName": "Tower Theatre",
            "VenueUrl": "https://localhost:2431/venue/tower-theatre-276525",
            "CityId": 42436,
            "CityName": "Oklahoma City",
            "CityUrl": "https://localhost:2431/city/oklahoma-city-42436",
            "State": "OK",
            "Country": "United States",
            "Region": "Oklahoma City, OK",
            "HasEventTickets": false,
            "PlayDate": "4/7/2018",
            "HoursOld": 4196,
            "IsFestival": false,
            "Support": "Unknown Hinson"
        }
    ]
}
<root>
    <page>0</page>
    <pageSize>0</pageSize>
    <totalPages>1</totalPages>
    <totalEvents>3</totalEvents>
    <fromDate>4/1/2018</fromDate>
    <toDate>5/1/2018</toDate>
    <events>
        <event>
            <EventId>10310460</EventId>
            <EventName>Reverend Horton Heat</EventName>
            <EventUrl>https://localhost:2431/event/reverend-horton-heat-6009336</EventUrl>
            <VenueId>109117546</VenueId>
            <VenueName>Growlers</VenueName>
            <VenueUrl>https://localhost:2431/venue/growlers-109117546</VenueUrl>
            <CityId>37224</CityId>
            <CityName>Memphis</CityName>
            <CityUrl>https://localhost:2431/city/memphis-37224</CityUrl>
            <State>TN</State>
            <Country>United States</Country>
            <Region>Memphis, TN</Region>
            <HasEventTickets>true</HasEventTickets>
            <PlayDate>4/5/2018</PlayDate>
            <HoursOld>4196</HoursOld>
            <IsFestival>false</IsFestival>
            <Support>Unknown Hinson</Support>
        </event>
        <event>
            <EventId>10310439</EventId>
            <EventName>Reverend Horton Heat</EventName>
            <EventUrl>https://localhost:2431/event/reverend-horton-heat-6009325</EventUrl>
            <VenueId>267942</VenueId>
            <VenueName>George's Majestic Lounge</VenueName>
            <VenueUrl>https://localhost:2431/venue/georges-majestic-lounge-267942</VenueUrl>
            <CityId>22025</CityId>
            <CityName>Fayetteville</CityName>
            <CityUrl>https://localhost:2431/city/fayetteville-22025</CityUrl>
            <State>AR</State>
            <Country>United States</Country>
            <Region>Fayetteville, AR</Region>
            <HasEventTickets>true</HasEventTickets>
            <PlayDate>4/6/2018</PlayDate>
            <HoursOld>4196</HoursOld>
            <IsFestival>false</IsFestival>
            <Support>Unknown Hinson</Support>
        </event>
        <event>
            <EventId>10310558</EventId>
            <EventName>Reverend Horton Heat</EventName>
            <EventUrl>https://localhost:2431/event/reverend-horton-heat-6009312</EventUrl>
            <VenueId>276525</VenueId>
            <VenueName>Tower Theatre</VenueName>
            <VenueUrl>https://localhost:2431/venue/tower-theatre-276525</VenueUrl>
            <CityId>42436</CityId>
            <CityName>Oklahoma City</CityName>
            <CityUrl>https://localhost:2431/city/oklahoma-city-42436</CityUrl>
            <State>OK</State>
            <Country>United States</Country>
            <Region>Oklahoma City, OK</Region>
            <HasEventTickets>false</HasEventTickets>
            <PlayDate>4/7/2018</PlayDate>
            <HoursOld>4196</HoursOld>
            <IsFestival>false</IsFestival>
            <Support>Unknown Hinson</Support>
        </event>
    </events>
</root>

 

%d bloggers like this: