openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

github.com/httptoolkit/openapi-directory-js

1 lines • 57.7 kB

JSON

{"openapi":"3.0.0","info":{"contact":{"x-twitter":"setlistfm"},"description":"\nThe setlist.fm API has been designed to give you easy access to setlist data in order to build fancy websites and\nother applications. Before starting to use the API, be sure to ...\n<ol>\n<li>... understand how setlist.fm works (the <a href=\"https://www.setlist.fm/faq\">FAQ</a> and the\n<a href=\"https://www.setlist.fm/guidelines\">Guidelines</a> are a good starting point),</li>\n<li>... read this documentation carefully and</li>\n<li>... <a href=\"https://www.setlist.fm/settings/api\">apply for an API key</a> (link for logged in users only) - if\nyou're no registered user yet, then <a href=\"https://www.setlist.fm/signup\">register first</a> (it's free).</li>\n</ol>\n\n\nIf this documentation isn't enough or if you've got other things you'd like to tell us about the API, visit the\n<a href=\"https://www.setlist.fm/forum/setlistfm/setlistfm-api\">API Forum</a>.\n\n\nNote that the setlist.fm API is, according to the <a href=\"https://www.setlist.fm/help/api-terms\">API terms of\nservice</a>, only free for non-commercial projects. If you're interested in using the API for commercial purposes,\n<a href=\"https://www.setlist.fm/contact\">contact us</a>.\n\n\n<h2>About this Service</h2>\n\nThis service provides methods to get both setlists and components of setlists such as artists, cities, countries or\nvenues.\n\n\n<h2>Supported Content Types</h2>\n\nThe REST service currently supports XML (default) and JSON content.\n\n\nTo receive a JSON response, set the <code>Accept</code>\n<a href=\"https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.1\">header</a> to application/json.\n\n\n<h2>Internationalization</h2>\n\n(Please note that this is an experimental feature and does not work for all cities!)\n\n\nMost of the featured methods honor the <code>Accept-Language</code>\n<a href=\"https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.4\">header</a>. This header is used for\nlocalizing cities and countries. The default language is English (en), but you can provide any of the languages\nSpanish (es), French (fr), German (de), Portuguese (pt), Turkish (tr), Italian (it) or Polish (pl).\n\n\nE.g. if you search a setlist for a concert that took place in Vienna and you pass "de" as header, you'll\nget "Wien, Österreich" instead of "Vienna, Austria". \nThis also works if you use a different language than the country's native language.\n\n\nE.g. for a concert in New York, you'll get "Nueva York, Estados Unidos" instead of "New\nYork, United States" if you pass "es" as language.\n\n\n<h2>API Keys</h2>\n\nAPI keys (<a href=\"https://www.setlist.fm/settings/api\">application form</a>) must be included in the request with\nthe <code>x-api-key</code> header.\n\n<h2>Version History</h2>\n<table class=\"table table-bordered table-versions\">\n<thead>\n<tr>\n<th>Version</th>\n<th>Docs</th>\n<th>End of Service</th>\n</tr>\n</thead> <tbody>\n<tr>\n<td>1.0</td>\n<td><a href=\"/docs/1.0\">Docs</a></td>\n<td>-</li>\n</tr>\n<tr>\n<td>0.1</td>\n<td></td>\n<td>December 31, 2017</li>\n</tr>\n</tbody>\n</table>","title":"setlist.fm API","version":"1.0","x-apisguru-categories":["media"],"x-logo":{"url":"https://twitter.com/setlistfm/profile_image?size=original"},"x-origin":[{"format":"swagger","url":"https://api.setlist.fm/docs/1.0/ui/swagger.json","version":"2.0"}],"x-providerName":"setlist.fm"},"tags":[{"name":"/1.0/artist/{mbid}"},{"name":"/1.0/artist/{mbid}/setlists"},{"name":"/1.0/city/{geoId}"},{"name":"/1.0/search/artists"},{"name":"/1.0/search/cities"},{"name":"/1.0/search/countries"},{"name":"/1.0/search/setlists"},{"name":"/1.0/search/venues"},{"name":"/1.0/setlist/version/{versionId}"},{"name":"/1.0/setlist/{setlistId}"},{"name":"/1.0/user/{userId}"},{"name":"/1.0/user/{userId}/attended"},{"name":"/1.0/user/{userId}/edited"},{"name":"/1.0/venue/{venueId}"},{"name":"/1.0/venue/{venueId}/setlists"}],"paths":{"/1.0/artist/{mbid}":{"get":{"description":"\nReturns an artist for a given Musicbrainz MBID\n","operationId":"resource__1.0_artist__mbid__getArtist_GET","parameters":[{"description":"a Musicbrainz MBID, e.g. 0bfba3d3-6a04-4779-bb0a-df07df5b0558","in":"path","name":"mbid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Artist"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Artist"},"examples":{"response":{"value":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"}}}}}}},"summary":".","tags":["/1.0/artist/{mbid}"]}},"/1.0/artist/{mbid}/setlists":{"get":{"description":"\nGet a list of an artist's setlists.\n","operationId":"resource__1.0_artist__mbid__setlists_getArtistSetlists_GET","parameters":[{"description":"the Musicbrainz MBID of the artist","in":"path","name":"mbid","required":true,"schema":{"type":"string"}},{"description":"the number of the result page","in":"query","name":"p","schema":{"type":"integer","default":"1"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlists"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42}}}}}}},"summary":".","tags":["/1.0/artist/{mbid}/setlists"]}},"/1.0/city/{geoId}":{"get":{"description":"Get a city by its unique geoId.","operationId":"resource__1.0_city__geoId__getCity_GET","parameters":[{"description":"the city's geoId","in":"path","name":"geoId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_City"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_City"},"examples":{"response":{"value":{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"}}}}}}},"summary":"Get a city by its unique geoId.","tags":["/1.0/city/{geoId}"]}},"/1.0/search/artists":{"get":{"description":"Search for artists.","operationId":"resource__1.0_search_artists_getArtists_GET","parameters":[{"description":"the artist's Musicbrainz Identifier (mbid)","in":"query","name":"artistMbid","schema":{"type":"string"}},{"description":"the artist's name","in":"query","name":"artistName","schema":{"type":"string"}},{"description":"the artist's Ticketmaster Identifier (tmid)","in":"query","name":"artistTmid","schema":{"type":"integer"}},{"description":"the number of the result page you'd like to have","in":"query","name":"p","schema":{"type":"integer","default":"1"}},{"description":"the sort of the result, either sortName (default) or relevance","in":"query","name":"sort","schema":{"type":"string","default":"sortName"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Artists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Artists"},"examples":{"response":{"value":{"artist":[{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."}],"itemsPerPage":20,"page":1,"total":42}}}}}}},"summary":"Search for artists.","tags":["/1.0/search/artists"]}},"/1.0/search/cities":{"get":{"description":"Search for a city.","operationId":"resource__1.0_search_cities_getCities_GET","parameters":[{"description":"the city's country","in":"query","name":"country","schema":{"type":"string"}},{"description":"name of the city","in":"query","name":"name","schema":{"type":"string"}},{"description":"the number of the result page you'd like to have","in":"query","name":"p","schema":{"type":"integer","default":"1"}},{"description":"state the city lies in","in":"query","name":"state","schema":{"type":"string"}},{"description":"state code the city lies in","in":"query","name":"stateCode","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Cities"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Cities"},"examples":{"response":{"value":{"cities":[{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},{"coords":{"lat":12345,"long":12345},"country":{"code":"...","name":"..."},"id":"...","name":"...","state":"...","stateCode":"..."}],"itemsPerPage":20,"page":1,"total":42}}}}}}},"summary":"Search for a city.","tags":["/1.0/search/cities"]}},"/1.0/search/countries":{"get":{"description":"Get a complete list of all supported countries.","operationId":"resource__1.0_search_countries_getCountries_GET","responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Countries"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Countries"},"examples":{"response":{"value":{"country":[{"code":"US","name":"United States"},{"code":"...","name":"..."}],"itemsPerPage":20,"page":1,"total":42}}}}}}},"summary":"Get a complete list of all supported countries.","tags":["/1.0/search/countries"]}},"/1.0/search/setlists":{"get":{"description":"Search for setlists.","operationId":"resource__1.0_search_setlists_getSetlists_GET","parameters":[{"description":"the artist's Musicbrainz Identifier (mbid)","in":"query","name":"artistMbid","schema":{"type":"string"}},{"description":"the artist's name","in":"query","name":"artistName","schema":{"type":"string"}},{"description":"the artist's Ticketmaster Identifier (tmid)","in":"query","name":"artistTmid","schema":{"type":"integer"}},{"description":"the city's geoId","in":"query","name":"cityId","schema":{"type":"string"}},{"description":"the name of the city","in":"query","name":"cityName","schema":{"type":"string"}},{"description":"the country code","in":"query","name":"countryCode","schema":{"type":"string"}},{"description":"the date of the event (format dd-MM-yyyy)","in":"query","name":"date","schema":{"type":"string"}},{"description":"the event's Last.fm Event ID (deprecated)","in":"query","name":"lastFm","schema":{"type":"integer"}},{"description":"the date and time (UTC) when this setlist was last updated (format yyyyMMddHHmmss) - either edited or\nreverted. search will return setlists that were updated on or after this date","in":"query","name":"lastUpdated","schema":{"type":"string"}},{"description":"the number of the result page","in":"query","name":"p","schema":{"type":"integer","default":"1"}},{"description":"the state","in":"query","name":"state","schema":{"type":"string"}},{"description":"the state code","in":"query","name":"stateCode","schema":{"type":"string"}},{"description":"","in":"query","name":"tourName","schema":{"type":"string"}},{"description":"the venue id","in":"query","name":"venueId","schema":{"type":"string"}},{"description":"the name of the venue","in":"query","name":"venueName","schema":{"type":"string"}},{"description":"the year of the event","in":"query","name":"year","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlists"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42}}}}}}},"summary":"Search for setlists.","tags":["/1.0/search/setlists"]}},"/1.0/search/venues":{"get":{"description":"Search for venues.","operationId":"resource__1.0_search_venues_getVenues_GET","parameters":[{"description":"the city's geoId","in":"query","name":"cityId","schema":{"type":"string"}},{"description":"name of the city where the venue is located","in":"query","name":"cityName","schema":{"type":"string"}},{"description":"the city's country","in":"query","name":"country","schema":{"type":"string"}},{"description":"name of the venue","in":"query","name":"name","schema":{"type":"string"}},{"description":"the number of the result page you'd like to have","in":"query","name":"p","schema":{"type":"integer","default":"1"}},{"description":"the city's state","in":"query","name":"state","schema":{"type":"string"}},{"description":"the city's state code","in":"query","name":"stateCode","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Venues"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Venues"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"total":42,"venue":[{"city":{"coords":{},"country":{},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},{"city":{"coords":{},"country":{},"id":"...","name":"...","state":"...","stateCode":"..."},"id":"...","name":"...","url":"..."}]}}}}}}},"summary":"Search for venues.","tags":["/1.0/search/venues"]}},"/1.0/setlist/version/{versionId}":{"get":{"description":"\nReturns a setlist for the given versionId. The setlist returned isn't necessarily the most recent version. E.g.\nif you pass the versionId of a setlist that got edited since you last accessed it, you'll get the same version as\nlast time.\n","operationId":"resource__1.0_setlist_version__versionId__getSetlistVersion_GET","parameters":[{"description":"the version id","in":"path","name":"versionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlist"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlist"},"examples":{"response":{"value":{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"Yesterday","tape":false,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]},{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"...","tape":true,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{"coords":{},"country":{},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"}}}}}}},"summary":".","tags":["/1.0/setlist/version/{versionId}"]}},"/1.0/setlist/{setlistId}":{"get":{"description":"\nReturns the current version of a setlist. E.g. if you pass the id of a setlist that got edited since you last\naccessed it, you'll get the current version.\n","operationId":"resource__1.0_setlist__setlistId__getSetlist_GET","parameters":[{"description":"the setlist id","in":"path","name":"setlistId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlist"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlist"},"examples":{"response":{"value":{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"Yesterday","tape":false,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]},{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"...","tape":true,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{"coords":{},"country":{},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"}}}}}}},"summary":".","tags":["/1.0/setlist/{setlistId}"]}},"/1.0/user/{userId}":{"get":{"description":"Get a user by userId. (deprecated)\n\nNote: This endpoint always returns a result, even if the user doesn't exist","operationId":"resource__1.0_user__userId__getUser_GET","parameters":[{"description":"the user's userId","in":"path","name":"userId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_User"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_User"},"examples":{"response":{"value":{"about":"...","flickr":"...","fullname":"...","lastFm":"...","mySpace":"...","twitter":"...","url":"...","userId":"...","website":"..."}}}}}}},"summary":"Get a user by userId.","tags":["/1.0/user/{userId}"]}},"/1.0/user/{userId}/attended":{"get":{"description":"\nGet a list of setlists of concerts attended by a user.\n","operationId":"resource__1.0_user__userId__attended_getUserAttendedSetlists_GET","parameters":[{"description":"the user's userId","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"the number of the result page","in":"query","name":"p","schema":{"type":"integer","default":"1"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlists"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42}}}}}}},"summary":".","tags":["/1.0/user/{userId}/attended"]}},"/1.0/user/{userId}/edited":{"get":{"description":"\nGet a list of setlists of concerts edited by a user. The list contains the current version, not the version\nedited.\n","operationId":"resource__1.0_user__userId__edited_getUserEditedSetlists_GET","parameters":[{"description":"the user's userId","in":"path","name":"userId","required":true,"schema":{"type":"string"}},{"description":"the number of the result page","in":"query","name":"p","schema":{"type":"integer","default":"1"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlists"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42}}}}}}},"summary":".","tags":["/1.0/user/{userId}/edited"]}},"/1.0/venue/{venueId}":{"get":{"description":"Get a venue by its unique id.","operationId":"resource__1.0_venue__venueId__getVenue_GET","parameters":[{"description":"the venue's id","in":"path","name":"venueId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Venue"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Venue"},"examples":{"response":{"value":{"city":{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"}}}}}}},"summary":"Get a venue by its unique id.","tags":["/1.0/venue/{venueId}"]}},"/1.0/venue/{venueId}/setlists":{"get":{"description":"\nGet setlists for a specific venue.\n","operationId":"resource__1.0_venue__venueId__setlists_getVenueSetlists_GET","parameters":[{"description":"the id of the venue","in":"path","name":"venueId","required":true,"schema":{"type":"string"}},{"description":"the number of the result page","in":"query","name":"p","schema":{"type":"integer","default":"1"}}],"responses":{"200":{"description":"Success","headers":{},"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/json_Setlists"}},"application/json":{"schema":{"$ref":"#/components/schemas/json_Setlists"},"examples":{"response":{"value":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42}}}}}}},"summary":".","tags":["/1.0/venue/{venueId}/setlists"]}}},"servers":[{"url":"/rest"}],"components":{"schemas":{"json_Artist":{"description":"This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite\n<a href=\"http://wiki.musicbrainz.org/MBID\">Musicbrainz Identifier</a> (MBID) with which the artist can be uniquely\nidentified.","example":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"properties":{"disambiguation":{"description":"disambiguation to distinguish between artists with same names","example":"John, Paul, George and Ringo","type":"string"},"mbid":{"description":"unique Musicbrainz Identifier (MBID), e.g. "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"","example":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","type":"string"},"name":{"description":"the artist's name, e.g. "The Beatles"","example":"The Beatles","type":"string"},"sortName":{"description":"the artist's sort name, e.g. "Beatles, The" or "Springsteen, Bruce"","example":"Beatles, The","type":"string"},"tmid":{"description":"unique Ticket Master Identifier (TMID), e.g. 735610","example":735610,"type":"number"},"url":{"description":"the attribution url","example":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html","type":"string"}},"title":"artist","type":"object"},"json_Artists":{"description":"A Result consisting of a list of artists.","example":{"artist":[{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."}],"itemsPerPage":20,"page":1,"total":42},"properties":{"artist":{"description":"result list of artists","items":{"$ref":"#/components/schemas/json_Artist"},"type":"array"},"itemsPerPage":{"description":"the amount of items you get per page","example":20,"type":"number"},"page":{"description":"the current page. starts at 1","example":1,"type":"number"},"total":{"description":"the total amount of items matching the query","example":42,"type":"number"}},"title":"artists","type":"object"},"json_Cities":{"description":"A Result consisting of a list of cities.","example":{"cities":[{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},{"coords":{"lat":12345,"long":12345},"country":{"code":"...","name":"..."},"id":"...","name":"...","state":"...","stateCode":"..."}],"itemsPerPage":20,"page":1,"total":42},"properties":{"cities":{"description":"result list of cities","items":{"$ref":"#/components/schemas/json_City"},"type":"array"},"itemsPerPage":{"description":"the amount of items you get per page","example":20,"type":"number"},"page":{"description":"the current page. starts at 1","example":1,"type":"number"},"total":{"description":"the total amount of items matching the query","example":42,"type":"number"}},"title":"cities","type":"object"},"json_City":{"description":"This class represents a city where Venues are located. Most of the original city data was taken from\n<a href=\"http://geonames.org/\">Geonames.org</a>.","example":{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"properties":{"coords":{"$ref":"#/components/schemas/json_Coords"},"country":{"$ref":"#/components/schemas/json_Country"},"id":{"description":"unique identifier","example":"5357527","type":"string"},"name":{"description":"the city's name, depending on the language valid values are e.g. "Müchen" or\nMunich","example":"Hollywood","type":"string"},"state":{"description":"The name of city's state, e.g. "Bavaria" or "Florida"","example":"California","type":"string"},"stateCode":{"description":"The code of the city's state. For most countries this is a two-digit numeric code, with which the state can be\nidentified uniquely in the specific Country. The code can also be a String for other cities. Valid\nexamples are "CA" or "02"\n\nwhich in turn get uniquely identifiable when combined with the state's country:\n\n"US.CA" for California, United States or "DE.02" for Bavaria, Germany\n\nFor a complete list of available states (that aren't necessarily used in this database) is available in\n<a href= \"http://download.geonames.org/export/dump/admin1CodesASCII.txt\">a textfile on geonames.org</a>.\n\nNote that this code is only unique combined with the city's Country. The code alone is\nnot unique.","example":"CA","type":"string"}},"title":"city","type":"object"},"json_Coords":{"description":"Coordinates of a point on the globe. Mostly used for Cities.","example":{"lat":34.0983425,"long":-118.3267434},"properties":{"lat":{"description":"The latitude part of the coordinates.","example":34.0983425,"type":"number"},"long":{"description":"The longitude part of the coordinates.","example":-118.3267434,"type":"number"}},"title":"coords","type":"object"},"json_Countries":{"description":"A Result consisting of a list of countries.","example":{"country":[{"code":"US","name":"United States"},{"code":"...","name":"..."}],"itemsPerPage":20,"page":1,"total":42},"properties":{"country":{"description":"result list of countries","items":{"$ref":"#/components/schemas/json_Country"},"type":"array"},"itemsPerPage":{"description":"the amount of items you get per page","example":20,"type":"number"},"page":{"description":"the current page. starts at 1","example":1,"type":"number"},"total":{"description":"the total amount of items matching the query","example":42,"type":"number"}},"title":"countries","type":"object"},"json_Country":{"description":"This class represents a country on earth.","example":{"code":"US","name":"United States"},"properties":{"code":{"description":"The country's <a href= \"http://www.iso.org/iso/english_country_names_and_code_elements\" >ISO code</a>. E.g.\n"ie" for Ireland","example":"US","type":"string"},"name":{"description":"The country's name. Can be a localized name - e.g. "Austria" or\n"Österreich" for Austria if the German name was requested.","example":"United States","type":"string"}},"title":"country","type":"object"},"json_Error":{"description":"Returned in case of an error.","example":{"code":404,"message":"unknown mbid","status":"Not Found","timestamp":"2016-12-08T17:52:48.817+0000"},"properties":{"code":{"description":"the HTTP status code","example":404,"type":"number"},"message":{"description":"an additional error message","example":"unknown mbid","type":"string"},"status":{"description":"the HTTP status message","example":"Not Found","type":"string"},"timestamp":{"description":"current timestamp","example":"2016-12-08T17:52:48.817+0000","type":"string"}},"title":"error","type":"object"},"json_Set":{"description":"A setlist consists of different (at least one) sets. Sets can either be sets as defined in the\n<a href=\"https://www.setlist.fm/guidelines\">Guidelines</a> or encores.","example":{"encore":12345,"name":"...","song":[{"cover":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"info":"...","name":"Yesterday","tape":false,"with":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"}},{"cover":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"info":"...","name":"...","tape":true,"with":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."}}]},"properties":{"encore":{"description":"if the set is an encore, this is the number of the encore, starting with 1 for the first encore, 2 for the second\nand so on.","type":"number"},"name":{"description":"the description/name of the set. E.g. "Acoustic set" or "Paul McCartney\nsolo"","type":"string"},"song":{"description":"this set's songs","items":{"$ref":"#/components/schemas/json_Song"},"type":"array"}},"title":"set","type":"object"},"json_Setlist":{"description":"Setlists, that's what it's all about. So if you're trying to use this API without knowing what a setlist is then\nyou're kinda wrong on this page ;-).\n\nA setlist can be distinguished from other setlists by its unique id. But as\n<a href=\"https://www.setlist.fm/\">setlist.fm</a> works the wiki way, there can be different versions of one setlist\n(each time a user updates a setlist a new version gets created). These different versions have a unique id on its\nown. So setlists can have the same id although they differ as far as the content is concerned - thus the best way to\ncheck if two setlists are the same is to compare their versionIds.","example":{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"Yesterday","tape":false,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]},{"encore":12345,"name":"...","song":[{"cover":{},"info":"...","name":"...","tape":true,"with":{}},{"cover":{},"info":"...","name":"...","tape":true,"with":{}}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{"coords":{},"country":{},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},"properties":{"artist":{"$ref":"#/components/schemas/json_Artist"},"eventDate":{"description":"date of the concert in the format "dd-MM-yyyy"","example":"23-08-1964","type":"string"},"id":{"description":"unique identifier","example":"63de4613","type":"string"},"info":{"description":"additional information on the concert - see the <a href=\"https://www.setlist.fm/guidelines\">setlist.fm\nguidelines</a> for a complete list of allowed content.","example":"Recorded and published as 'The Beatles at the Hollywood Bowl'","type":"string"},"lastFmEventId":{"description":"the id this event has on <a href=\"http://last.fm/\">last.fm</a> (deprecated)","example":1164056,"type":"number"},"lastUpdated":{"description":"date, time and time zone of the last update to this setlist in the format\n"yyyy-MM-dd'T'HH:mm:ss.SSSZZZZZ"","example":"2013-10-20T05:18:08.000+0000","type":"string"},"set":{"description":"all sets of this setlist","items":{"$ref":"#/components/schemas/json_Set"},"type":"array"},"tour":{"$ref":"#/components/schemas/json_Tour"},"url":{"description":"the attribution url to which you have to link to wherever you use data from this setlist in your application","example":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","type":"string"},"venue":{"$ref":"#/components/schemas/json_Venue"},"versionId":{"description":"unique identifier of the version","example":"7be1aaa0","type":"string"}},"title":"setlist","type":"object"},"json_Setlists":{"description":"A Result consisting of a list of setlists.","example":{"itemsPerPage":20,"page":1,"setlist":[{"artist":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"eventDate":"23-08-1964","id":"63de4613","info":"Recorded and published as 'The Beatles at the Hollywood Bowl'","lastUpdated":"2013-10-20T05:18:08.000+0000","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"North American Tour 1964"},"url":"https://www.setlist.fm/setlist/the-beatles/1964/hollywood-bowl-hollywood-ca-63de4613.html","venue":{"city":{},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"versionId":"7be1aaa0"},{"artist":{"disambiguation":"...","mbid":"...","name":"...","sortName":"...","tmid":12345,"url":"..."},"eventDate":"...","id":"...","info":"...","lastUpdated":"...","set":[{"encore":12345,"name":"...","song":[{},{}]},{"encore":12345,"name":"...","song":[{},{}]}],"tour":{"name":"..."},"url":"...","venue":{"city":{},"id":"...","name":"...","url":"..."},"versionId":"..."}],"total":42},"properties":{"itemsPerPage":{"description":"the amount of items you get per page","example":20,"type":"number"},"page":{"description":"the current page. starts at 1","example":1,"type":"number"},"setlist":{"description":"result list of setlists","items":{"$ref":"#/components/schemas/json_Setlist"},"type":"array"},"total":{"description":"the total amount of items matching the query","example":42,"type":"number"}},"title":"setlists","type":"object"},"json_Song":{"description":"This class represents a song that is part of a Set.","example":{"cover":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"},"info":"...","name":"Yesterday","tape":false,"with":{"disambiguation":"John, Paul, George and Ringo","mbid":"b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d","name":"The Beatles","sortName":"Beatles, The","tmid":735610,"url":"https://www.setlist.fm/setlists/the-beatles-23d6a88b.html"}},"properties":{"cover":{"$ref":"#/components/schemas/json_Artist"},"info":{"description":"Special incidents or additional information about the way the song was performed at this specific concert. See\nthe <a href=\"https://www.setlist.fm/guidelines\">setlist.fm guidelines</a> for a complete list of allowed content.","type":"string"},"name":{"description":"The name of the song. E.g. Yesterday or "Wish You Were Here"","example":"Yesterday","type":"string"},"tape":{"description":"The song came from tape rather than being performed live. See the\n<a href=\"https://www.setlist.fm/guidelines#tape-songs\">tape section of the guidelines</a> for valid usage.","example":false,"type":"boolean"},"with":{"$ref":"#/components/schemas/json_Artist"}},"title":"song","type":"object"},"json_Tour":{"description":"The tour a setlist was a part of.","example":{"name":"North American Tour 1964"},"properties":{"name":{"description":"The name of the tour.","example":"North American Tour 1964","type":"string"}},"title":"tour","type":"object"},"json_User":{"description":"This class represents a user.","example":{"about":"...","flickr":"...","fullname":"...","lastFm":"...","mySpace":"...","twitter":"...","url":"...","userId":"...","website":"..."},"properties":{"about":{"description":"never set (deprecated)","type":"string"},"flickr":{"description":"never set (deprecated)","type":"string"},"fullname":{"description":"never set (deprecated)","type":"string"},"lastFm":{"description":"never set (deprecated)","type":"string"},"mySpace":{"description":"never set (deprecated)","type":"string"},"twitter":{"description":"never set (deprecated)","type":"string"},"url":{"description":"","type":"string"},"userId":{"description":"","type":"string"},"website":{"description":"never set (deprecated)","type":"string"}},"title":"user","type":"object"},"json_Venue":{"description":"Venues are places where concerts take place. They usually consist of a venue name and a city - but there are also\nsome venues that do not have a city attached yet. In such a case, the city simply isn't set and the city and country\nmay (but do not have to) be in the name.","example":{"city":{"coords":{"lat":34.0983425,"long":-118.3267434},"country":{"code":"US","name":"United States"},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},"properties":{"city":{"$ref":"#/components/schemas/json_City"},"id":{"description":"unique identifier","example":"6bd6ca6e","type":"string"},"name":{"description":"the name of the venue, usually without city and country. E.g. "Madison Square Garden" or\n"Royal Albert Hall"","example":"Compaq Center","type":"string"},"url":{"description":"the attribution url","example":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html","type":"string"}},"title":"venue","type":"object"},"json_Venues":{"description":"A Result consisting of a list of venues.","example":{"itemsPerPage":20,"page":1,"total":42,"venue":[{"city":{"coords":{},"country":{},"id":"5357527","name":"Hollywood","state":"California","stateCode":"CA"},"id":"6bd6ca6e","name":"Compaq Center","url":"https://www.setlist.fm/venue/compaq-center-san-jose-ca-usa-6bd6ca6e.html"},{"city":{"coords":{},"country":{},"id":"...","name":"...","state":"...","stateCode":"..."},"id":"...","name":"...","url":"..."}]},"properties":{"itemsPerPage":{"description":"the amount of items you get per page","example":20,"type":"number"},"page":{"description":"the current page. starts at 1","example":1,"type":"number"},"total":{"description":"the total amount of items matching the query","example":42,"type":"number"},"venue":{"description":"result list of venues","items":{"$ref":"#/components/schemas/json_Venue"},"type":"array"}},"title":"venues","type":"object"},"xml_ns0_artist":{"allOf":[{"properties":{"disambiguation":{"description":"disambiguation to distinguish between artists with same names","type":"string","xml":{"attribute":true}},"mbid":{"description":"unique Musicbrainz Identifier (MBID), e.g. "b10bbbfc-cf9e-42e0-be17-e2c3e1d2600d"","type":"string","xml":{"attribute":true}},"name":{"description":"the artist's name, e.g. "The Beatles"","type":"string","xml":{"attribute":true}},"sortName":{"description":"the artist's sort name, e.g. "Beatles, The" or "Springsteen, Bruce"","type":"string","xml":{"attribute":true}},"tmid":{"description":"unique Ticket Master Identifier (TMID), e.g. 735610","type":"number","xml":{"attribute":true}},"url":{"description":"the attribution url","type":"string","xml":{}}}}],"description":"This class represents an artist. An artist is a musician or a group of musicians. Each artist has a definite\n<a href=\"http://wiki.musicbrainz.org/MBID\">Musicbrainz Identifier</a> (MBID) with which the artist can be uniquely\nidentified.","required":["mbid","sortName","name","url"],"title":"artist","type":"object"},"xml_ns0_artists":{"allOf":[{"$ref":"#/components/schemas/xml_ns0_result"},{}],"description":"A Result consisting of a list of artists.","title":"artists","type":"object"},"xml_ns0_cities":{"allOf":[{"$ref":"#/components/schemas/xml_ns0_result"},{}],"description":"A Result consisting of a list of cities.","title":"cities","type":"object"},"xml_ns0_city":{"allOf":[{"properties":{"coords":{"$ref":"#/components/schemas/xml_ns0_coords"},"country":{"$ref":"#/components/schemas/xml_ns0_country"},"id":{"description":"unique identifier","type":"string","xml":{"attribute":true}},"name":{"description":"the city's name, depending on the language valid values are e.g. "Müchen" or\nMunich","type":"string","xml":{"attribute":true}},"state":{"description":"The name of city's state, e.g. "Bavaria" or "Florida"","type":"string","xml":{"attribute":true}},"stateCode":{"description":"The code of the city's state. For most countries this is a two-digit numeric code, with which the state can be\nidentified uniquely in the specific Country. The code can also be a String for other cities. Valid\nexamples are "CA" or "02"\n\nwhich in turn get uniquely identifiable when combined with the state's country:\n\n"US.CA" for California, United States or "DE.02" for Bavaria, Germany\n\nFor a complete list of available states (that aren't necessarily used in this database) is available in\n<a href= \"http://download.geonames.org/export/dump/admin1CodesASCII.txt\">a textfile on geonames.org</a>.\n\nNote that this code is only unique combined with the city's Country. The code alone is\nnot unique.","type":"string","xml":{"attribute":true}}}}],"description":"This class represents a city where Venues are located. Most of the original city data was taken from\n<a href=\"http://geonames.org/\">Geonames.org</a>.","required":["id","name","country"],"title":"city","type":"object"},"xml_ns0_coords":{"allOf":[{"properties":{"lat":{"description":"The latitude part of the coordinates.","type":"number","xml":{"attribute":true}},"long":{"description":"The longitude part of the coordinates.","type":"number","xml":{"attribute":true}}}}],"description":"Coordinates of a point on the globe. Mostly used for Cities.","required":["lat","long"],"title":"coords","type":"object"},"xml_ns0_countries":{"allOf":[{"$ref":"#/components/schemas/xml_ns0_result"},{}],"description":"A Result consisting of a list of countries.","title":"countries","type":"object"},"xml_ns0_country":{"allOf":[{"properties":{"code":{"description":"The country's <a href= \"http://www.iso.org/iso/english_country_names_and_code_elements\" >ISO code</a>. E.g.\n"ie" for Ireland","type":"string","xml":{"attribute