--- title: "Search for setlists." method: GET path: "/1.0/search/setlists" tags: ["/1.0/search/setlists"] --- # Search for setlists. `GET /1.0/search/setlists` Search for setlists. ## Query parameters - `artistMbid` string - `artistName` string - `artistTmid` integer - `cityId` string - `cityName` string - `countryCode` string - `date` string - `lastFm` integer - `lastUpdated` string - `p` integer - `state` string - `stateCode` string - `tourName` string - `venueId` string - `venueName` string - `year` string ## Response `200` Success - JsonSetlists — A Result consisting of a list of setlists. - `setlist` JsonSetlist[] — result list of setlists - `artist` JsonArtist — This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite Musicbrainz Identifier (MBID) with which the artist can be uniquely identified. - `mbid` string — unique Musicbrainz Identifier (MBID), e.g. "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d" - `tmid` number — unique Ticket Master Identifier (TMID), e.g. 735610 (deprecated) - `name` string — the artist's name, e.g. "The Beatles" - `sortName` string — the artist's sort name, e.g. "Beatles, The" or "Springsteen, Bruce" - `disambiguation` string — disambiguation to distinguish between artists with same names - `url` string — the attribution url - `venue` JsonVenue — Venues are places where concerts take place. They usually consist of a venue name and a city - but there are also some venues that do not have a city attached yet. In such a case, the city simply isn't set and the city and country may (but do not have to) be in the name. - `city` JsonCity — This class represents a city where Venues are located. Most of the original city data was taken from Geonames.org. - `id` string — unique identifier - `name` string — the city's name, depending on the language valid values are e.g. "Müchen" or Munich - `stateCode` string — The code of the city's state. For most countries this is a two-digit numeric code, with which the state can be identified uniquely in the specific Country. The code can also be a String for other cities. Valid examples are "CA" or "02" which in turn get uniquely identifiable when combined with the state's country: "US.CA" for California, United States or "DE.02" for Bavaria, Germany For a complete list of available states (that aren't necessarily used in this database) is available in a textfile on geonames.org. Note that this code is only unique combined with the city's Country. The code alone is not unique. - `state` string — The name of city's state, e.g. "Bavaria" or "Florida" - `coords` JsonCoords — Coordinates of a point on the globe. Mostly used for Cities. - `long` number — The longitude part of the coordinates. - `lat` number — The latitude part of the coordinates. - `country` JsonCountry — This class represents a country on earth. - `code` string — The country's ISO code. E.g. "ie" for Ireland - `name` string — The country's name. Can be a localized name - e.g. "Austria" or "Österreich" for Austria if the German name was requested. - `url` string — the attribution url - `id` string — unique identifier - `name` string — the name of the venue, usually without city and country. E.g. "Madison Square Garden" or "Royal Albert Hall" - `tour` JsonTour — The tour a setlist was a part of. - `name` string — The name of the tour. - `set` JsonSet[] — all sets of this setlist - `name` string — the description/name of the set. E.g. "Acoustic set" or "Paul McCartney solo" - `encore` number — if the set is an encore, this is the number of the encore, starting with 1 for the first encore, 2 for the second and so on. - `song` JsonSong[] — this set's songs - `name` string — The name of the song. E.g. Yesterday or "Wish You Were Here" - `with` JsonArtist — This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite Musicbrainz Identifier (MBID) with which the artist can be uniquely identified. - `mbid` string — unique Musicbrainz Identifier (MBID), e.g. "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d" - `tmid` number — unique Ticket Master Identifier (TMID), e.g. 735610 (deprecated) - `name` string — the artist's name, e.g. "The Beatles" - `sortName` string — the artist's sort name, e.g. "Beatles, The" or "Springsteen, Bruce" - `disambiguation` string — disambiguation to distinguish between artists with same names - `url` string — the attribution url - `cover` JsonArtist — This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite Musicbrainz Identifier (MBID) with which the artist can be uniquely identified. - `mbid` string — unique Musicbrainz Identifier (MBID), e.g. "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d" - `tmid` number — unique Ticket Master Identifier (TMID), e.g. 735610 (deprecated) - `name` string — the artist's name, e.g. "The Beatles" - `sortName` string — the artist's sort name, e.g. "Beatles, The" or "Springsteen, Bruce" - `disambiguation` string — disambiguation to distinguish between artists with same names - `url` string — the attribution url - `info` string — Special incidents or additional information about the way the song was performed at this specific concert. See the setlist.fm guidelines for a complete list of allowed content. - `tape` boolean — The song came from tape rather than being performed live. See the tape section of the guidelines for valid usage. - `info` string — additional information on the concert - see the setlist.fm guidelines for a complete list of allowed content. - `url` string — the attribution url to which you have to link to wherever you use data from this setlist in your application - `id` string — unique identifier - `versionId` string — unique identifier of the version - `lastFmEventId` number — the id this event has on last.fm (deprecated) - `eventDate` string — date of the concert in the format "dd-MM-yyyy" - `lastUpdated` string — date, time and time zone of the last update to this setlist in the format "yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ" - `total` number — the total amount of items matching the query - `page` number — the current page. starts at 1 - `itemsPerPage` number — the amount of items you get per page --- [API](https://skmtc.dev/setlist/apis/setlist-fm-api.md) · [All operations](https://skmtc.dev/setlist/apis/setlist-fm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/setlist/setlist-fm-api/revisions/16af169c0ca3/schema)