Developer Help Center

Retrieving Distribution Status

Use the distribution/store/all resource to get the distribution status for a release.

Note

If the distribution status indicates an error has occurred, please attempt to resolve the error with the information below. This may involve simply waiting for an error to resolve itself or editing metadata and redistributing. Please contact customer support with your releaseId(s) for additional assistance.

GET /distribution/store/all

Table 1. Query String Parameters

Parameter

Description

token

Optional*

Access token returned upon authentication.

*Providing a token is mandatory, but alternatively, it can be provided as a header. See Authentication and Headers.

options.releaseId

Optional

The ID of the release for which to get distribution information. This ID was returned in the /content/release/save request which created the release.

Including this parameter narrows the response to only this release.



curl -X GET 'http://staging-api.revelator.com/distribution/store/all?options.releaseId=540650&token=2ec6ba54-3199-473a-a129-296bf672a759'\ 
--header 'Accept: application/json'  

Response. Each object in the items array represents a release being sent to a specific store. The releaseId indicates the release and the distributorStoreId indicates the store (DSP). The status and statusText parameters in the releaseStatus object indicate the status.

Table 2. Distribution Statuses

Status

Status text

Additional Information

-13

Rejected by Inspector

Metadata for the release was rejected (in parent account)

-11

Parked/Hidden

Release hidden from metadata inspection queue

-10

Pending Approval

Pending metadata inspection (Before distribution is approved in the parent account)

0

Pending

Initiating distribution (Immediately after metadata approval in the parent account)

4

Waiting for download assets

Waiting to download files hosted at external URLs from the cloud

5

Downloading external assets

Downloading files from the cloud

6

Downloading external assets failed

Downloading a file failed. Please verify the provided external URL is public and triggers a download of the file (server hosting the file must return a content-disposition header set to “attachment”)

8

Waiting for audio encoding

 

10

Encoding audio files

 

11

Audio encoding failed

Encoding audio failed. Re-queueing the release may fix the problem; if not, please contact customer support.

20

Ready for release validation

Waiting for metadata validation

21

Validation failed

Release has failed the DSP's unique metadata validation; see the errorMessage for more information.

  • These validation issues must be fixed by editing the release and re-adding it to the distribution queue. In order to edit parameters that cannot be edited for locked releases, you must unlock, edit, relock, and then add to queue.

    For more information about which fields can and cannot be edited for locked releases, see Updating Distributed Releases.

  • If validation failed because of a missing UPC/ISRC and the release's metadata indicates that Revelator should generate the UPC/ISRC, please contact customer support.

Note

Sometimes YouTube will indicate an error that does not require a fix; it is simply a warning/alert.

30

Ready for package creation

Waiting for package creation

31

Creating package

 

32

Package creation failed

The majority of the time, this indicates a temporary error that will resolve itself; this is due to the system optimizing for speed of delivery vs. 100% delivery on the first try. See the errorMessage for more information.

  • "The process cannot access the file" - Error will self-resolve in 24 hours or less

  • "Sequence contains no matching element" - Typically an error when the DSP is YouTube CID (307) or Facebook RM (310), and it means that a monetization policy is missing for at least 1 track.

  • "Object reference not set to an instance of an object" - There are many causes for this error; in general it indicates that one of the expected references is missing, like the Artist ID for one of the contributors.

40

Ready for upload

Waiting for upload

41

Uploading package

 

42

Package upload failed

Uploading the package failed. Re-queueing the release may fix the problem; if not, please contact customer support.

50

Pending Approval

Uploaded/delivered to the DSP

60

On store

Confirmed as available on the DSP

70

Waiting for Takedown

 

71

Removing from store

Removing from DSP

77

Removing failed

Taking down the release failed. Re-queueing the takedown may fix the problem; if not, please contact customer support.

78

Takedown request delivered

 

79

Removed from store

Takedown confirmed by DSP

100

Error in process, please try again.

Processing error



{ 
    "totalItemsCount": 3, 
    "pageNumber": 1, 
    "pageSize": 3, 
    "items": [ 
        { 
            "releaseId": 0, 
            "distributorStoreId": 1, 
            "albumsCount": 0, 
            "singlesCount": 0, 
            "epCount": 0, 
            "ringtonesCount": 0, 
            "videosCount": 0, 
            "totalQuantity": 0, 
            "totalNet": 0.0, 
            "releasePriceId": null, 
            "trackPriceId": null, 
            "releaseStatus": { 
                "status": -10, 
                "statusText": "Pending Approval", 
                "errorMessage": null, 
                "addedDate": "2019-12-19T09:15:56.15", 
                "deliveryDate": null, 
                "dateLive": null, 
                "urlInStore": null, 
                "summarySection": 5, 
                "isError": false 
            }, 
            "inProgressCount": 0, 
            "inspectionCount": 0, 
            "licensingCount": 0, 
            "deliveredCount": 0, 
            "mayBeLiveCount": 0, 
            "liveCount": 0, 
            "errorCount": 0 
        }, 
        { 
            "releaseId": 0, 
            "distributorStoreId": 6,             
            "albumsCount": 0, 
            "singlesCount": 0, 
            "epCount": 0, 
            "ringtonesCount": 0, 
            "videosCount": 0, 
            "totalQuantity": 0, 
            "totalNet": 0.0, 
            "releasePriceId": null, 
            "trackPriceId": null, 
            "releaseStatus": { 
                "status": -10, 
                "statusText": "Pending Approval", 
                "errorMessage": null, 
                "addedDate": "2019-12-19T09:16:05.417", 
                "deliveryDate": null, 
                "dateLive": null, 
                "urlInStore": null, 
                "summarySection": 5, 
                "isError": false 
            }, 
            "inProgressCount": 0, 
            "inspectionCount": 0, 
            "licensingCount": 0, 
            "deliveredCount": 0, 
            "mayBeLiveCount": 0, 
            "liveCount": 0, 
            "errorCount": 0 
        },
        { 
            "releaseId": 0, 
            "distributorStoreId": 315, 
            "albumsCount": 0, 
            "singlesCount": 0, 
            "epCount": 0, 
            "ringtonesCount": 0, 
            "videosCount": 0,             
            "totalQuantity": 0, 
            "totalNet": 0.0, 
            "releasePriceId": null, 
            "trackPriceId": null, 
            "releaseStatus": { 
                "status": -10, 
                "statusText": "Pending Approval", 
                "errorMessage": null, 
                "addedDate": "2019-12-19T09:15:56.413", 
                "deliveryDate": null, 
                "dateLive": null, 
                "urlInStore": null, 
                "summarySection": 5, 
                "isError": false 
            }, 
            "inProgressCount": 0, 
            "inspectionCount": 0, 
            "licensingCount": 0, 
            "deliveredCount": 0, 
            "mayBeLiveCount": 0, 
            "liveCount": 0, 
            "errorCount": 0 
        } 
    ], 
    "аdditionalCounters": null }