curl --request GET \
--url https://api.royalti.io/ddex/messages/{messageId} \
--header 'Authorization: Bearer <token>'{
"status": "<string>",
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageId": "<string>",
"messageType": "ERN",
"version": "<string>",
"providerId": "<string>",
"productId": "<string>",
"assetIds": [
"<string>"
],
"artistId": "<string>",
"status": "pending",
"fileSize": 123,
"updatedAt": "2023-11-07T05:31:56Z",
"messageThreadId": "thread_abc123",
"xmlContent": "<?xml version=\"1.0\"?>...",
"deliveryAttempts": 1,
"lastDeliveryAttempt": "2023-11-07T05:31:56Z",
"acknowledgementReceived": "2023-11-07T05:31:56Z",
"errorMessage": "Connection timeout to FTP server",
"validationResult": {
"isValid": true,
"errors": [
"<string>"
],
"warnings": [
"<string>"
]
},
"deliverySettings": {
"priority": "low",
"retryPolicy": {
"maxAttempts": 123,
"backoffMultiplier": 123
},
"timeout": 123
},
"metadata": {
"generatedBy": "<string>",
"processingTime": 123,
"batchId": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"code": "<string>",
"dpid": "<string>",
"category": "streaming",
"defaultDeliveryMethod": "SFTP",
"deliveryMethods": [
"SFTP"
],
"territories": [
"<string>"
],
"supportedFormats": [
"<string>"
],
"technicalSpecs": {},
"rateLimits": {},
"acknowledgementSettings": {},
"description": "<string>",
"isActive": true,
"website": "<string>",
"documentation": "<string>"
},
"product": {
"id": "<string>",
"title": "<string>",
"displayArtist": "<string>",
"upc": "<string>"
},
"ernDeliveries": [
{
"messageId": "<string>",
"providerId": "<string>",
"deliveryStatus": "pending",
"deliveryMethod": "SFTP",
"deliveryAttempts": 123,
"deliveredAt": "2023-11-07T05:31:56Z",
"acknowledgedAt": "2023-11-07T05:31:56Z",
"errorMessage": "<string>"
}
],
"statusHistory": [
{
"status": "draft",
"statusDate": "2023-11-07T05:31:56Z",
"details": {},
"errorCode": "<string>",
"errorMessage": "<string>"
}
]
}
}Get a DDEX message
curl --request GET \
--url https://api.royalti.io/ddex/messages/{messageId} \
--header 'Authorization: Bearer <token>'{
"status": "<string>",
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"messageId": "<string>",
"messageType": "ERN",
"version": "<string>",
"providerId": "<string>",
"productId": "<string>",
"assetIds": [
"<string>"
],
"artistId": "<string>",
"status": "pending",
"fileSize": 123,
"updatedAt": "2023-11-07T05:31:56Z",
"messageThreadId": "thread_abc123",
"xmlContent": "<?xml version=\"1.0\"?>...",
"deliveryAttempts": 1,
"lastDeliveryAttempt": "2023-11-07T05:31:56Z",
"acknowledgementReceived": "2023-11-07T05:31:56Z",
"errorMessage": "Connection timeout to FTP server",
"validationResult": {
"isValid": true,
"errors": [
"<string>"
],
"warnings": [
"<string>"
]
},
"deliverySettings": {
"priority": "low",
"retryPolicy": {
"maxAttempts": 123,
"backoffMultiplier": 123
},
"timeout": 123
},
"metadata": {
"generatedBy": "<string>",
"processingTime": 123,
"batchId": "<string>"
},
"createdAt": "2023-11-07T05:31:56Z",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"code": "<string>",
"dpid": "<string>",
"category": "streaming",
"defaultDeliveryMethod": "SFTP",
"deliveryMethods": [
"SFTP"
],
"territories": [
"<string>"
],
"supportedFormats": [
"<string>"
],
"technicalSpecs": {},
"rateLimits": {},
"acknowledgementSettings": {},
"description": "<string>",
"isActive": true,
"website": "<string>",
"documentation": "<string>"
},
"product": {
"id": "<string>",
"title": "<string>",
"displayArtist": "<string>",
"upc": "<string>"
},
"ernDeliveries": [
{
"messageId": "<string>",
"providerId": "<string>",
"deliveryStatus": "pending",
"deliveryMethod": "SFTP",
"deliveryAttempts": 123,
"deliveredAt": "2023-11-07T05:31:56Z",
"acknowledgedAt": "2023-11-07T05:31:56Z",
"errorMessage": "<string>"
}
],
"statusHistory": [
{
"status": "draft",
"statusDate": "2023-11-07T05:31:56Z",
"details": {},
"errorCode": "<string>",
"errorMessage": "<string>"
}
]
}
}const response = await fetch('https://api.royalti.io/ddex/messages/example-id', {
method: 'GET',
});
const data = await response.json();
console.log(data);