Albums by Label

 

Get Albums

GetAlbum returns all Albums for a specific Library. The Library is an optional requirement, if omitted all albums will be returned for the account.

Returns service details which include one or more Album elements (active albums only).

Request:

GET /getalbums/{serviceToken}/{libraryID}

Parameter Type Status
ServiceToken String Mandatory
libraryID String Optional

To return inactive Albums in the response append /includeinactive to your request for example:

/getalbums/{serviceToken}/includeinactive
/getalbums/{serviceToken}/libraryID/includeinactive

To return styles in the response append /returnstyle to your request for example:

/getalbums/{serviceToken}/returnstyle
/getalbums/{serviceToken}/libraryID/returnstyle

 

Successful Response (libraryID omitted from request)

<responsealbums>
<albums>
<album libraryid="06edad5205192a78" featured="false" releasedate="2012-01-01 00:00:00" code="EDS 001" detail="Fierce. Edgy. Urban. Gritty." name="Dubstep & Grime"displaytitle="EDS 001 Dubstep & Grime" keywords="Inner City, Urban Life, Streets, Gritty, Action, Underground, Underworld" id="8bf678f220d4c3d2" status="active"lastupdated="2015-12-18 00:57:09" />
</albums>
</responsealbums>

Successful Response (libraryID included in request)

<responsealbums>
<albums>
<album featured=”false” code=”HM001″ detail=”Razor-sharp pop&amp; rock bristling with spiky guitars &amp; infectious, feelgood inspiration … and tons of attitude.” name=”HM 001 Sample Album” displaytitle=”HM 001 Sample Album ” id=”1c5f4ffffffffff2f3″ lastupdated=”2013-02-11 12:29:18″/>
<album featured=”false” code=”HM002″ detail=” Contemporary beats fused with orchestral elements.” name=”HM 002 Sample Album ” displaytitle=”HM 002 Sample Album ” id=”67ddddddd06″ lastupdated=”2013-02-11 12:29:18″><linebreaks>
<linebreak name=”At Home” id=”f057bfffff29b” abovetrack=”0053ffff779″ />
<linebreak name=”Out &amp; About” id=”df09fffff3b9b” abovetrack=”ecc7ffffff9e1b” />
</linebreaks>
</album>
</albums>
</responsealbums>

Error Response:

<responselibraries>

 

<error>

<code>5</code>

<description>Invalid Token</description>

</error>

</responselibraries>

 

 

Get Albums by ID

Request: 

POST getalbumsbyids/{sessionToken}

 

<requestalbums>
<albumid id="9dfffffffff41" />
<albumid id="d3gggggggggb0" />
</requestalbums>

Response:

<responsealbums>
<albums>
<album featured="false" releasedate="2003-02-01 00:00:00" code="WOM 002" detail="Smokey blue piano Jazz." name="Bluekey" displaytitle="WOM 002 Bluekey" keywords="Jazz Trio, Dinner Jazz" id="d31FFFFFFFFFFFF0" status="active" lastupdated="2015-01-08 09:25:57">
<linebreaks>
<linebreak name="60" Versions" id="c92c8DDDDDDDD8d" abovetrack="aDD75DDDDDDDD95" />
<linebreak name="30" Versions" id="d8DDDDDDDDDedd" abovetrack="f81111111111aa" />
</linebreaks>
</album>
<album featured="false" releasedate="2003-02-01 00:00:00" code="WOM 003" detail=""Warm electronica, chilled out beats and ambient underscores."" name="Regression"displaytitle="WOM 003 Regression" keywords="Space, Technology, Chilled, Atmospheres, Dreamy, Relaxation, Atmospheric, Calm, Peaceful" id="ba9fFFFFFFFFF38" status="active"lastupdated="2015-01-08 09:33:20">
<linebreaks>
<linebreak name="60" Versions" id="44446cFFEE154444" abovetrack="8FFFFFFFFFFF81" />
<linebreak name="30" Versions" id="555cb01555e5EEEb" abovetrack="d3FFFFFFFFFF9e" />
 </linebreaks>
</album>
</albums>
</responsealbums>

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Article is closed for comments.