Public
Documentation Settings
Select option
Double Column
Select option
Symphonia
Introduction
Album
Artists
browse
follow
library
Personalization
Player
Playlists
recommendations
Search
Tracks
Users
Devices

Symphonia

error response

if a request went wrong due to misuse or server error an error response will be sent it will have two fields

field description possible values
statusit describes the source of the error if value is fail it means the error comes from the sender of the request else if its value was error it means it's a server error and should return for the back end developers to solve that issueerror | fail
msg or messageit contains information about the error which is safe to send to the user as it doesn't contain any sensetive datayou have to be logged in!

Album

GETGet Several Albums

{{URL}}api/v1/albums?ids=5e701f4d2672a63a60573a02,5e701fdf2672a63a60573a06
PARAMS
ids

5e701f4d2672a63a60573a02,5e701fdf2672a63a60573a06

comma separated ids of the albums you want to retrieve their data

Example Request
Get Several Albums
curl
curl --location -g '{{URL}}api/v1/albums?ids=5e701f4d2672a63a60573a02%2C5e701fdf2672a63a60573a06'
200 OK
Example Response
json
[
  {
    "tracks": [
      {
        "category": [
          "5e807517e478cf39b47bd1f0"
        ],
        "explicit": false,
        "_id": "5e7d334860cd930408a5f995",
        "album": "5e701f4d2672a63a60573a02",
        "name": "Everything Is Wrong",
        "durationMs": 30000,
        "artist": "5e82a48054660672fd699883",
        "trackPath": "assets/tracks/Everything-Is-Wrong.mp3",
        "premium": false,
        "type": "track"
      },
      {
        "category": [
          "5e807517e478cf39b47bd1f0"
        ],
        "explicit": false,
        "_id": "5e8a1e0f7937ec4d40c6deba",
        "album": "5e701f4d2672a63a60573a02",
        "name": "My Desire",
        "durationMs": 30000,
        "artist": "5e82a48054660672fd699883",
        "trackPath": "assets/tracks/My-Desire.mp3",
        "premium": true,
        "type": "track"
      },
      {
        "category": [
          "5e807517e478cf39b47bd1f0"
        ],
        "explicit": false,
        "_id": "5e8a1e727937ec4d40c6debb",
        "album": "5e701f4d2672a63a60573a02",
        "name": "All The Rage Back Home",
        "durationMs": 30000,
        "artist": "5e82a48054660672fd699883",
        "trackPath": "assets/tracks/All-The-Rage-Back-Home.mp3",
        "premium": false,
        "type": "track"
      }
    ],
    "releaseDate": "2020-04-16T00:07:21.580Z",
    "_id": "5e701f4d2672a63a60573a02",
    "name": "El Pintor",
    "year": 2014,
    "image": "https://thesymphonia.ddns.net/api/v1/images/albums/El-Pintor.jpg",
    "artist": {
      "queue": {
        "currentlyPlaying": {
          "currentTrack": null
        },
        "queueTracks": [],
        "previousTrack": null,
        "repeat": false,
        "shuffle": false,
        "play": false,
        "repeatOnce": false,
        "devices": [
          {
            "_id": "5e8a5b0db2859207bf1fc2e9",
            "devicesName": "chrome"
          }
        ]
      },
      "followedUsers": [],
      "tracks": [
        "5e7d334860cd930408a5f995",
        "5e8a1e0f7937ec4d40c6deba",
        "5e8a1e727937ec4d40c6debb"
      ],
      "ownedPlaylists": [],
      "followedAlbums": [],
      "followedTracks": [],
      "_id": "5e82a48054660672fd699883",
      "email": "test4@test.com",
      "name": "Interpol",
      "dateOfBirth": "1979-12-25T00:00:00.000Z",
      "gender": "male",
      "type": "artist",
      "imageUrl": "https://thesymphonia.ddns.net/api/v1/images/users/Interpol.jpg"
    }
  },
  {
    "tracks": [
      {
        "category": [
          "5e8072e5e478cf39b47bd1ef"
        ],
        "explicit": false,
        "_id": "5e7d2dc03429e24340ff1396",
        "album": "5e701fdf2672a63a60573a06",
        "name": "Instant Destiny",
        "durationMs": 30000,
        "artist": "5e8137aa54660672fd699882",
        "trackPath": "assets/tracks/Instant-Destiny.mp3",
        "premium": false,
        "type": "track"
      },
      {
        "category": [
          "5e8072e5e478cf39b47bd1ef"
        ],
        "explicit": false,
        "_id": "5e7d2ddd3429e24340ff1397",
        "album": "5e701fdf2672a63a60573a06",
        "name": "Borderline",
        "durationMs": 30000,
        "artist": "5e8137aa54660672fd699882",
        "trackPath": "assets/tracks/Borderline.mvk",
        "premium": false,
        "type": "track"
      },
      {
        "category": [
          "5e8072e5e478cf39b47bd1ef"
        ],
        "explicit": false,
        "_id": "5e7d2e023429e24340ff1398",
        "album": "5e701fdf2672a63a60573a06",
        "name": "Posthumous Forgiveness",
        "durationMs": 30000,
        "artist": "5e8137aa54660672fd699882",
        "trackPath": "assets/tracks/Posthumous-Forgiveness.mp3",
        "premium": true,
        "type": "track"
      }
    ],
    "releaseDate": "2020-04-16T00:07:21.580Z",
    "_id": "5e701fdf2672a63a60573a06",
    "name": "The Slow Rush",
    "year": 2020,
    "image": "https://thesymphonia.ddns.net/api/v1/images/albums/The-Slow-Rush.jpg",
    "artist": {
      "queue": {
        "currentlyPlaying": {
          "currentTrack": null
        },
        "queueTracks": [],
        "previousTrack": null,
        "repeat": false,
        "shuffle": false,
        "play": false,
        "repeatOnce": false,
        "devices": [
          {
            "_id": "5e8a5b0db2859207bf1fc2e9",
            "devicesName": "chrome"
          }
        ]
      },
      "followedUsers": [],
      "tracks": [
        "5e7d2dc03429e24340ff1396",
        "5e7d2ddd3429e24340ff1397",
        "5e7d2e023429e24340ff1398"
      ],
      "ownedPlaylists": [],
      "followedAlbums": [],
      "followedTracks": [],
      "_id": "5e8137aa54660672fd699882",
      "email": "test3@test.com",
      "name": "Tame Impala",
      "dateOfBirth": "1978-06-25T00:00:00.000Z",
      "gender": "male",
      "type": "artist",
      "imageUrl": "https://thesymphonia.ddns.net/api/v1/images/users/Tame-Impala.jpg"
    }
  }
]
Access-Control-Allow-Origin

*

X-DNS-Prefetch-Control

off

X-Frame-Options

SAMEORIGIN

Strict-Transport-Security

max-age=15552000; includeSubDomains

X-Download-Options

noopen

X-Content-Type-Options

nosniff

X-XSS-Protection

1; mode=block

Content-Type

application/json; charset=utf-8

ETag

W/"d3b-7XzQAqz7DYbPGo6Z31dOqTQcqZ0"

Vary

Accept-Encoding

Content-Encoding

gzip

Date

Thu, 16 Apr 2020 00:10:06 GMT

Connection

keep-alive

Transfer-Encoding

chunked

GETGet an Album

{{URL}}api/v1/albums/:{id}
PATH VARIABLES
{id}

5e701f4d2672a63a60573a02

The Symphonia id for the document you want to retrieve

Example Request
Get an Album
curl
curl --location -g '{{URL}}api/v1/albums/5e701f4d2672a63a60573a02'
200 OK
Example Response
json
{
  "copyrights": {
    "text": "Eu excepteur velit cillum dolor enim amet dolore magna. Voluptate \n      enim ipsum pariatur est ut proident reprehenderit non et aliquip magna est velit. \n      Consectetur in enim nostrud labore nulla veniam laborum eiusmod quis ex aliqua nisi dolor.\n      Aliquip Lorem dolore nulla Lorem exercitation ad tempor cillum consectetur. \n      Ad cillum occaecat aliqua amet pariatur.",
    "type": "C"
  },
  "tracks": [
    {
      "_id": "5e7d334860cd930408a5f995",
      "name": "Everything Is Wrong"
    },
    {
      "_id": "5e8a1e0f7937ec4d40c6deba",
      "name": "My Desire"
    },
    {
      "_id": "5e8a1e727937ec4d40c6debb",
      "name": "All The Rage Back Home"
    }
  ],
  "type": "album",
  "releaseDate": "2014-09-08T00:00:00.000Z",
  "_id": "5e701f4d2672a63a60573a02",
  "name": "El Pintor",
  "image": "https://thesymphonia.ddns.net/api/v1/images/albums/El-Pintor.jpg",
  "artist": {
    "_id": "5e82a48054660672fd699883",
    "name": "Interpol"
  },
  "albumType": "album",
  "tracksCount": 3,
  "id": "5e701f4d2672a63a60573a02"
}
Access-Control-Allow-Origin

*

X-DNS-Prefetch-Control

off

X-Frame-Options

SAMEORIGIN

Strict-Transport-Security

max-age=15552000; includeSubDomains

X-Download-Options

noopen

X-Content-Type-Options

nosniff

X-XSS-Protection

1; mode=block

Content-Type

application/json; charset=utf-8

Content-Length

932

ETag

W/"3a4-Y9BeC6hkE2tr2S1DE4gVFdXKvJA"

Vary

Accept-Encoding

Date

Mon, 25 May 2020 19:24:37 GMT

Connection

keep-alive