Audicient API
  • Getting Started
  • Authentication
    • Signing Up New Users
  • Common
  • Media
    • Image
      • Get image
      • Upload Image
      • Update image
    • Audio
      • Get audio
      • Upload audio
      • Update audio
  • Users
  • Contracts
    • Get User Contract
    • Update User Contract
    • Remove stores for a account
    • Terminate Account
  • Artists
    • List all artists
    • Create artist
    • Get Artist Details
    • Update Artist
  • Labels
    • List all labels
    • Create label
    • Get Label Details
    • Update Label
  • Releases
    • Get Releases
    • Get Release Detail
    • Get Tracks
    • Save Release
  • Distribution
    • QC Approval
    • Remove store from delivery
    • Add release to delivery queue
    • Upload Release on Consolidated Independent / State 51
    • Upload on FUGA
Powered by GitBook
On this page
  • API Endpoint
  • Authentication Requirements
  • Response
  1. Releases

Get Release Detail

API Endpoint

GET /release/:releaseId
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

Response

Success Response (200 OK)

{
  "release": {
    "releaseId": 124504,
    "type": 1,
    "imageId": "bddab078-53b3-4233-89df-d7d10169269e",
    "name": "Release Name",
    "version": null,
    "languageId": 1,
    "artistId": 128709,
    "primaryMusicStyleId": 221,
    "secondaryMusicStyleId": 25,
    "pYear": "2023",
    "pLine": "Random Label",
    "cYear": "2023",
    "cLine": "Random Label",
    "previouslyReleased": true,
    "previouslyReleasedDate": "2016-02-12T09:15:10.599Z",
    "hasLabel": false,
    "labelId": null,
    "hasUpc": true,
    "upc": "12345678119",
    "catalog": null,
    "releaseDate": "2008-11-19T06:01:06.977Z",
    "qcStatus": false,
    "qcApprovedAt": null,
    "tracks": 1,
    "duration": 220,
    "enterpriseId": 781024,
    "tenantId": "57e5ba5e-d619-48a1-a8a1-9a0ff5052239",
    "createdAt": "1998-07-03T18:21:50.457Z",
    "updatedAt": "2013-10-09T00:16:07.979Z",
    "contributors": [],
    "artist": {
      "artistId": 128709,
      "name": "Artist Name",
      "spotifyId": "4fsTDaHeTk9ZS5MBLwrLF7",
      "appleId": "1506933610",
      "imageId": "2642ddb0-c075-443b-b019-bd2a2ba32bde"
    },
    "label": null
  },
  "tracks": [
    {
      "trackId": 847787,
      "releaseId": 741504,
      "audioId": "2f77993f-3c50-4a5d-8282-c1523bf0247a",
      "name": "Random Track Name",
      "version": null,
      "languageId": 37,
      "artistId": 128709,
      "explicitContent": false,
      "hasIsrc": true,
      "isrc": "NLRD5196650",
      "trackOrigin": 1,
      "duration": 435,
      "primaryMusicStyleId": 221,
      "secondaryMusicStyleId": 25,
      "pYear": "2023",
      "pLine": "Random Label",
      "previewTime": 40,
      "lyrics": "",
      "catalog": null,
      "enterpriseId": 781024,
      "tenantId": "57e5ba5e-d619-48a1-a8a1-9a0ff5052239",
      "createdAt": "2022-01-09T02:54:36.419Z",
      "updatedAt": "2003-06-04T04:45:21.339Z",
      "contributors": [],
      "composerContentsDTO": [
        {
          "roleId": 39,
          "name": "Composer Name"
        }
      ],
      "artist": {
        "name": "Artist Name",
        "spotifyId": "4fsTDaHeTk9ZS5MBLwrLF7",
        "appleId": "1506933610",
        "imageId": "8c0da5e7-17e4-4522-ac43-4e8bb6cf8bcf"
      }
    }
  ],
  "retails": [
    {
      "id": 62,
      "releaseId": 124504,
      "distributorStoreId": 1,
      "status": 4,
      "statusText": "live",
      "subStatusText": "live",
      "errorMessage": null,
      "addedDate": "2025-03-11T19:35:17.070Z",
      "deliveryDate": "2025-03-15T00:00:00.000Z",
      "firstDeliveryDate": "2025-03-15T00:00:00.000Z",
      "dateLive": "2025-03-16T00:00:00.000Z",
      "urlInStore": null,
      "summarySection": null,
      "isError": null
    },
    ....
  ]
}
PreviousGet ReleasesNextGet Tracks

Last updated 2 months ago