Usage & ReportingDownload raw DRM delivery logs

Download raw DRM delivery logs

Streams a CSV, JSON or NDJSON export of raw delivery log records for the given time period. start and end must fall within the same UTC calendar month, and within DRMtoday's retention window (the current UTC month, plus the previous month for a short grace period after it ends). A single export is capped at 1,000,000 records. On success the response body is the file itself - use the Content-Disposition header for the filename and Content-Type for the format. On failure the usual JSON error envelope is returned instead, still with HTTP 200.

curl -X POST "https://api.5centscdn.com/v2/drm/usage/download" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
  "deliveryType": "LICENSE",
  "downloadType": "JSON_STREAM",
  "start": "2026-09-01T00:00:00Z",
  "end": "2026-09-23T18:50:00Z",
  "status": "OK",
  "scheme": "WIDEVINE_MODULAR"
}'
{
  "result": "error",
  "message": "The time period cannot span more than one calendar month (UTC) - DRMToday rejects cross-month log requests."
}
POST
/drm/usage/download
POST
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

Content-Typestring
Required

The media type of the request body

Options: application/json
deliveryTypestring

Delivery type to export. Defaults to LICENSE.

Options: LICENSE, RENEWAL, CERTIFICATE
downloadTypestring

Export format. JSON_STREAM is newline-delimited JSON (recommended for large exports), JSON is a single JSON array, CSV is comma-separated with a reduced field subset. Defaults to JSON_STREAM.

Options: JSON_STREAM, JSON, CSV
startstring
Required

Inclusive start of the export window (ISO-8601). Any timezone offset is accepted and converted to UTC.

Format: date-time
endstring
Required

Exclusive end of the export window (ISO-8601). Must be in the same UTC calendar month as start.

Format: date-time
statusstring

Optional filter to a single delivery status. Omit for all statuses.

Options: OK, DENIED, REVOKED, INVALID, FAIL, ERROR
schemestring

Optional filter to a single DRM scheme. Omit for all schemes.

Options: WIDEVINE_MODULAR, PLAYREADY, FAIRPLAY, WISEPLAY
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Body

application/json
deliveryTypestring

Delivery type to export. Defaults to LICENSE.

Allowed values:LICENSERENEWALCERTIFICATE
downloadTypestring

Export format. JSON_STREAM is newline-delimited JSON (recommended for large exports), JSON is a single JSON array, CSV is comma-separated with a reduced field subset. Defaults to JSON_STREAM.

Allowed values:JSON_STREAMJSONCSV
startstring
Required

Inclusive start of the export window (ISO-8601). Any timezone offset is accepted and converted to UTC.

Example:
2026-09-01T00:00:00Z
endstring
Required

Exclusive end of the export window (ISO-8601). Must be in the same UTC calendar month as start.

Example:
2026-09-23T18:50:00Z
statusstring

Optional filter to a single delivery status. Omit for all statuses.

Allowed values:OKDENIEDREVOKEDINVALIDFAILERROR
schemestring

Optional filter to a single DRM scheme. Omit for all schemes.

Allowed values:WIDEVINE_MODULARPLAYREADYFAIRPLAYWISEPLAY

Responses

resultstring

Operation outcome. Only present on failure.

messagestring

Human-readable error message. Only present on failure.