@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Bandsintown API
@base https://rest.bandsintown.com
@version 3.0.0
@endpoints 2
@toc artists(2)

@endpoint GET /artists/{artistname}
@desc Get artist information
@required {artistname: any # The name of the artist. If it contains one of the special characters below, please be sure to replace it by the corresponding code: for / use %252F, for ? use %253F, for * use %252A, and for " use %27C, app_id: any # The application ID assigned to you by Bandsintown}
@returns(200) 200 response

@endpoint GET /artists/{artistname}/events
@desc Get upcoming, past, or all artist events, or events within a date range
@required {artistname: any # The name of the artist. If it contains one of the special characters below, please be sure to replace it by the corresponding code: for / use %252F, for ? use %253F, for * use %252A, and for " use %27C, app_id: any # The application ID assigned to you by Bandsintown}
@optional {date: any # Can be one of the following values: "upcoming", "past", "all", or a date range e.g. "2015-05-05,2017-05-05". If not specified, only upcoming shows are returned}
@returns(200) Shows within a date range for the selected artist

@end