Get Releases

API Endpoint

GET /release
Host: api.audicient.com
Authorization: <API_KEY>:<API_SECRET>

Authentication Requirements

All requests must include authentication credentials.

• Authorization Header: Pass the API key and secret as <API_KEY>:<API_SECRET>.

• Enterprise-ID Header: Required when accessing releases at the account level. Example:

  enterprise-id: 100001

Query Parameters

Parameter	Type	Description	Default
orderByDescending	boolean	Whether to sort results in descending order (true or false).	true
orderByProperty	string	Property to sort by.	createdAt
pageSize	number	Number of items per page.	20
pageNumber	number	The page number to retrieve.	1
fromDate	string	Filter results from this date (ISO format).	optional
toDate	string	Filter results up to this date (ISO format).	optional
searchText	string	Search query to filter releases.	"" (empty string)

Response

Success Response (200 OK)

{
  "totalItemsCount": 1,
  "pageNumber": 1,
  "pageSize": 20,
  "items": [
    {
      "name": "Release",
      "version": null,
      "artistName": "Artist 1",
      "artistId": 100001,
      "labelName": null,
      "labelId": 100002,
      "createdAt": "2025-03-07T12:41:24.057Z",
      "releaseDate": "11/03/2025",
      "releaseId": 100001,
      "qcStatus": true,
      "qcApprovedAt": "2025-03-08T12:08:42.000Z",
      "imageId": "3de41ce3-7a89-407b-b2e7-01117c818595",
      "upc": "123456789012",
      "tracks": 2, //no of tracks in release
      "duration": 301 // total duration of album
    }
  ],
  "additionalCounters": null
}