DPM API

General notes

The DPM API collection enables customers to integrate with our systems directly. API access is through basic authentication using credentials supplied by the DPM admin.

API detail

Delivery

DPM delivery requests API

Post Delivery Request 

curl -X POST -d '        {
            "upc": "5056293896634",
            "dsp_name": "youtube",
            "delivery_type": "online"
        }' "{{host}}/api/v1/requestdelivery"
POST %7B%7Bhost%7D%7D/api/v1/requestdelivery HTTP/1.1
Host: 

        {
            "upc": "5056293896634",
            "dsp_name": "youtube",
            "delivery_type": "online"
        }
Status201 Created
Content-Typeapplication/json; charset=utf-8
Locationodata/Dpm/DeliveryRequests/1
ServerMicrosoft-IIS/10.0
DateThu, 29 Jul 2021 18:52:24 GMT
Content-Length156
{
    "id": 1,
    "upc": "5056293896634",
    "dsp_name": "Spotify",
    "delivery_type": "online",
    "request_date": "2021-07-29T14:52:23.2065064-04:00",
    "request_status": "Requested"
}

Get Delivery Requests 

curl -X GET "{{host}}/api/v1/requestdelivery"
GET %7B%7Bhost%7D%7D/api/v1/requestdelivery HTTP/1.1
Host:
Status401 Unauthorized
Transfer-Encodingchunked
ServerMicrosoft-IIS/10.0
WWW-AuthenticateBasic realm="", charset="UTF-8"
X-Powered-ByASP.NET
DateTue, 27 Jul 2021 23:27:34 GMT
Status200 OK
Transfer-Encodingchunked
Content-Typeapplication/json; charset=utf-8
ServerMicrosoft-IIS/10.0
DateMon, 16 Aug 2021 03:21:06 GMT
[
    {
        "apiuser_id": 2,
        "id": 17,
        "upc": "3760325342403",
        "delivery_type": "InitialDelivery",
        "delivery_status": "Delivered Approved ✅  (Deliver to DSP) ",
        "request_date": "2021-08-04T19:28:29.7782943",
        "last_updated": "2021-08-04T19:28:29.7782943"
    },
    {
        "apiuser_id": 2,
        "id": 455,
        "upc": "3760325343721",
        "delivery_type": "InitialDelivery",
        "delivery_status": "Submitted (Pending Approval)",
        "request_date": "2021-08-12T11:00:40.6983215",
        "last_updated": "2021-08-12T11:00:40.6983215"
    }
]

Get Delivery Requests with Parameters 

curl -X GET "{{host}}/api/v1/requestdelivery?upc=3760325342403"
GET %7B%7Bhost%7D%7D/api/v1/requestdelivery?upc=3760325342403 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json; charset=utf-8
ServerMicrosoft-IIS/10.0
DateMon, 16 Aug 2021 03:23:04 GMT
Content-Length234
[
    {
        "apiuser_id": 2,
        "id": 17,
        "upc": "3760325342403",
        "delivery_type": "InitialDelivery",
        "delivery_status": "Delivered Approved ✅  (Deliver to DSP) ",
        "request_date": "2021-08-04T19:28:29.7782943",
        "last_updated": "2021-08-04T19:28:29.7782943"
    }
]

Get Delivery Requests Store List 

curl -X GET "{{host}}/api/v1/dsp"
GET %7B%7Bhost%7D%7D/api/v1/dsp HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json; charset=utf-8
ServerMicrosoft-IIS/10.0
DateMon, 16 Aug 2021 03:06:36 GMT
Content-Length5038
[
    {
        "apiuser_id": 2,
        "id": 1,
        "store_name": "7Digital",
        "store_identifier": null
    },
    {
        "apiuser_id": 2,
        "id": 7,
        "store_name": "Audible Magic (Direct)",
        "store_identifier": null
    },
    {
        "apiuser_id": 2,
        "id": 9,
        "store_name": "AWA (Japan)",
        "store_identifier": null
    }
]

Get File Upload History 

curl -X GET "{{host}}/api/v1/fileuploads?upc=5056293896634&created_date_from=2020-01-01&created_date_to=2023-01-01"
GET %7B%7Bhost%7D%7D/api/v1/fileuploads?upc=5056293896634&created_date_from=2020-01-01&created_date_to=2023-01-01 HTTP/1.1
Host:
Status200 OK
Content-Typeapplication/json; charset=utf-8
ServerMicrosoft-IIS/10.0
Paging-Headers{"totalCount":1,"pageSize":10,"currentPage":1,"totalPages":1,"previousPage":"No","nextPage":"No"}
DateSun, 10 Apr 2022 15:42:22 GMT
Content-Length377
[
    {
        "id": 1,
        "apiuser_id": 1,
        "upc": "5056293896634",
        "create_date": "2022-04-09T16:40:19.0008651",
        "completed_date": "2022-04-09T16:40:30.0321953",
        "bucket_name": "nuemeta",
        "tgt_path": "/NewReleases/5056293896634/5056293896634_01_01.flac",
        "src_path": "NewReleases/5056293896634/5056293896634_01_01.flac",
        "src_type": "S3",
        "upload_status": "Completed",
        "spare1": null,
        "spare2": null,
        "spare3": null
    }
]

Reports

DPM reports API

Artist Sales Export

Download csv file artist sales report for year/month

curl -X GET "{{host}}/api/v1/reports/artistsales/2021/5"
GET %7B%7Bhost%7D%7D/api/v1/reports/artistsales/2021/5 HTTP/1.1
Host: