List releases
Releases sent through the API, newest first.
GET
/
delivery
/
releases
List releases
curl --request GET \
--url https://api.ammdistro.com/api/v2/external/delivery/releases \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ammdistro.com/api/v2/external/delivery/releases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"releases": [
{
"externalId": "NOVA-004",
"id": "<string>",
"accountId": "<string>",
"kind": "new",
"status": "draft",
"title": "<string>",
"version": "<string>",
"type": "<string>",
"releaseDate": "2023-12-25",
"originalReleaseDate": "2023-12-25",
"upc": "<string>",
"catalogNumber": "<string>",
"transfer": {
"batch": "<string>"
},
"artwork": {
"present": true,
"file": {
"id": "<string>",
"source": "url",
"status": "awaiting_upload",
"error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
"details": {}
}
},
"tracks": [
{
"externalId": "<string>",
"id": "<string>",
"discNumber": 123,
"trackNumber": 123,
"title": "<string>",
"isrc": "<string>",
"durationMs": 123,
"audio": {
"present": true,
"file": {
"id": "<string>",
"source": "url",
"status": "awaiting_upload",
"error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
"details": {}
}
}
}
],
"storeLinks": {
"spotify": "<string>",
"appleMusic": "<string>",
"deezer": "<string>",
"tidal": "<string>",
"amazonMusic": "<string>",
"youtubeMusic": "<string>"
},
"submittedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>"
}Authorizations
An API key from Settings → API in AMM Distro.
Query Parameters
Available options:
draft, in_review, changes_requested, delivering, delivered, live, rejected, taken_down Required when the key covers more than one account.
Required range:
1 <= x <= 100nextCursor from the previous page.
⌘I
List releases
curl --request GET \
--url https://api.ammdistro.com/api/v2/external/delivery/releases \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ammdistro.com/api/v2/external/delivery/releases"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"releases": [
{
"externalId": "NOVA-004",
"id": "<string>",
"accountId": "<string>",
"kind": "new",
"status": "draft",
"title": "<string>",
"version": "<string>",
"type": "<string>",
"releaseDate": "2023-12-25",
"originalReleaseDate": "2023-12-25",
"upc": "<string>",
"catalogNumber": "<string>",
"transfer": {
"batch": "<string>"
},
"artwork": {
"present": true,
"file": {
"id": "<string>",
"source": "url",
"status": "awaiting_upload",
"error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
"details": {}
}
},
"tracks": [
{
"externalId": "<string>",
"id": "<string>",
"discNumber": 123,
"trackNumber": 123,
"title": "<string>",
"isrc": "<string>",
"durationMs": 123,
"audio": {
"present": true,
"file": {
"id": "<string>",
"source": "url",
"status": "awaiting_upload",
"error": "The artwork file is 1200×1200; artwork must be at least 1400×1400",
"details": {}
}
}
}
],
"storeLinks": {
"spotify": "<string>",
"appleMusic": "<string>",
"deezer": "<string>",
"tidal": "<string>",
"amazonMusic": "<string>",
"youtubeMusic": "<string>"
},
"submittedAt": "2023-11-07T05:31:56Z",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"nextCursor": "<string>"
}