Check readiness
Everything that would stop the release from being submitted, plus warnings. Changes nothing; a read-only key is enough.
POST
/
delivery
/
releases
/
{releaseId}
/
validate
Check readiness
curl --request POST \
--url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/validate \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/validate', 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/{releaseId}/validate"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"ready": true,
"errors": [
{
"severity": "error",
"message": "<string>",
"rule": "credit.production",
"field": "credits",
"track": {
"externalId": "<string>",
"discNumber": 123,
"trackNumber": 123
}
}
],
"warnings": [
{
"severity": "error",
"message": "<string>",
"rule": "credit.production",
"field": "credits",
"track": {
"externalId": "<string>",
"discNumber": 123,
"trackNumber": 123
}
}
],
"release": {
"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"
}
}Authorizations
An API key from Settings → API in AMM Distro.
Path Parameters
Your ID for the release.
Pattern:
^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$Query Parameters
Required when the key covers more than one account.
⌘I
Check readiness
curl --request POST \
--url https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/validate \
--header 'Authorization: Bearer <token>'const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.ammdistro.com/api/v2/external/delivery/releases/{releaseId}/validate', 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/{releaseId}/validate"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text){
"ready": true,
"errors": [
{
"severity": "error",
"message": "<string>",
"rule": "credit.production",
"field": "credits",
"track": {
"externalId": "<string>",
"discNumber": 123,
"trackNumber": 123
}
}
],
"warnings": [
{
"severity": "error",
"message": "<string>",
"rule": "credit.production",
"field": "credits",
"track": {
"externalId": "<string>",
"discNumber": 123,
"trackNumber": 123
}
}
],
"release": {
"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"
}
}