Get a setlist
GET /api/setlists/{id}
GET
/api/setlists/{id}
Returns a specific setlist with all its songs in order.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ” id
required
UUID identifier
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000UUID identifier
Responses
Section titled “ Responses ”Setlist details
object
ok
required
boolean
data
required
object
id
required
UUID identifier
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000 name
required
string
date
Gig date (e.g., 2025-01-15)
string
songs
required
Array
object
id
required
UUID identifier
string format: uuid
Example
550e8400-e29b-41d4-a716-446655440000 title
required
string
artist
string
key
Musical key (e.g., Am, C, F#m)
string
tempo
BPM
integer
duration
Duration in seconds
integer
notes
Performance notes
string
timeSignature
Time signature (e.g., 4/4)
string
mediaUrl
Link to audio/video
string format: uri
tags
Array<string>
content
ChordPro formatted content (lyrics + chords)
string
leadVocal
Who sings lead
string
infoPa
Notes for sound engineer
string
twoColumnLayout
boolean
leadSheetUrl
string format: uri
updatedAt
string format: date-time
createdAt
string format: date-time
position
integer
sectionMarker
string
setlistNotes
string
updatedAt
string format: date-time
createdAt
string format: date-time
Unauthorized
object
ok
required
boolean
error
required
string
Setlist not found
object
ok
required
boolean
error
required
string