Mood by ID
GET /v0/moods/:moodId
Get mood details
Path Parameters
- moodId string required
Mood id
Query Parameters
- expand string
Possible values: [
tracks
]Add parameter if tracks should be included in the response
- limit int32
Max number of entries returned in the response, default 50 and max 100
- offset int32
Index of the entry track in the response
- 200
- 401
- 404
- 429
Track mood response
- application/json
- Schema
- Example (from schema)
- Example
Schema
- id string required
- name string required
images object
default string nullableL string nullableM string nullableS string nullableXS string nullabletracks object
tracks object[] required
Array [id string requiredUnique ID of the track
mainArtists string[] requiredThe main artist that created the track.
featuredArtists string[] requiredAdditional artists that contributed to the track.
title string requiredTitle of the track
bpm int32 requiredBeats per minute for the track.
length int32 requiredTrack length in seconds
moods object[] required
Lists the moods of the track.
Array [id string requiredUnique ID of the mood
name string requiredName of the mood
]genres object[] required
Lists the genres of the track.
Array [id string requiredname string requiredparent object
id string requiredUnique ID of the parent genre
name string requiredName of the parent genre
]images object
default string nullableL string nullableM string nullableS string nullableXS string nullablewaveformUrl string requiredReference to the waveform as a json object.
hasVocals boolean nullableSet to true if the track has vocals. Set to false for instrumental tracks.
added string requiredThe date the track was released in the format YYYY-mm-dd.
tierOption string nullablePossible values: [
PAID
,FREE
]isExplicit boolean nullableisPreviewOnly boolean]pagination object required
page int32 requiredlimit int32 requiredoffset int32links object required
next string nullableprev string nullableaggregations object
moods object[]
Array [id stringname stringcount int32]genres object[]
Array [id stringname stringcount int32]
{
"id": "string",
"name": "string",
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
},
"tracks": {
"tracks": [
{
"id": "string",
"mainArtists": [
"string"
],
"featuredArtists": [
"string"
],
"title": "string",
"bpm": 0,
"length": 0,
"moods": [
{
"id": "string",
"name": "string"
}
],
"genres": [
{
"id": "string",
"name": "string",
"parent": {
"id": "string",
"name": "string"
}
}
],
"images": {
"default": "string",
"L": "string",
"M": "string",
"S": "string",
"XS": "string"
},
"waveformUrl": "string",
"hasVocals": true,
"added": "string",
"tierOption": "PAID",
"isExplicit": true,
"isPreviewOnly": true
}
],
"pagination": {
"page": 0,
"limit": 0,
"offset": 0
},
"links": {
"next": "string",
"prev": "string"
},
"aggregations": {
"moods": [
{
"id": "string",
"name": "string",
"count": 0
}
],
"genres": [
{
"id": "string",
"name": "string",
"count": 0
}
]
}
}
}
{
"id": "happy",
"name": "Happy",
"images": {
"default": "https://images.ctfassets.net/ojtnytzl1djm/2u0eIu3GfevvONKEVc0NEi/f0db82add464ad37ec90406c8ab7cab1/Happy.png?w=300&h=300&fit=fill&q=90&fm=jpg",
"L": "https://images.ctfassets.net/ojtnytzl1djm/2u0eIu3GfevvONKEVc0NEi/f0db82add464ad37ec90406c8ab7cab1/Happy.png?w=1050&h=1050&fit=fill&q=90&fm=jpg",
"M": "https://images.ctfassets.net/ojtnytzl1djm/2u0eIu3GfevvONKEVc0NEi/f0db82add464ad37ec90406c8ab7cab1/Happy.png?w=600&h=600&fit=fill&q=90&fm=jpg",
"S": "https://images.ctfassets.net/ojtnytzl1djm/2u0eIu3GfevvONKEVc0NEi/f0db82add464ad37ec90406c8ab7cab1/Happy.png?w=300&h=300&fit=fill&q=90&fm=jpg",
"XS": "https://images.ctfassets.net/ojtnytzl1djm/2u0eIu3GfevvONKEVc0NEi/f0db82add464ad37ec90406c8ab7cab1/Happy.png?w=128&h=128&fit=fill&q=90&fm=jpg"
}
}
Unauthorized. Most likely your access token has expired.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Invalid credentials"
}
Mood was not found
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Mood was not found"
}
Rate limit exceeded.
- application/json
- Schema
- Example (from schema)
- Example
Schema
- message string required
Human readable message
errors object[]
Array [key string requiredError key
messages string[] requiredError messages
]
{
"message": "string",
"errors": [
{
"key": "string",
"messages": [
"string"
]
}
]
}
{
"message": "Rate limit exceeded"
}