Skip to the content
Get an API key
  1. API reference
  2. Billing and usage

Get failed requests over time

GET/public/analytics/errors
Core + Managed TransfersAuthBasicDocsSession

The failed requests of your account in each period, one row for each HTTP status code. Requires Client Secret authentication. Not billed.

Query parameters

startDate
stringrequired

The first day of the range (UTC), for example 2026-10-01. The day counts.

endDate
stringrequired

The last day of the range (UTC). The day counts, so startDate = endDate is one day. The range may hold at most 366 days, or 31 days for an hourly series.

granularity
hourly | daily | weekly | monthly · daily

The length of one period. A week starts on Sunday.

integrationType
spotify | appleMusic | youtube | tidal | resso | boomplay | amazonMusic | deezer | pandora | soundCloud | youtubeMusic | napster | qobuz | qqMusic | yandexMusic | vkMusic | anghami | zvuk | gaana | jiosaavn | audiomack

Count only the requests for this music service. Leave it out for every service.

Response

200application/json · UsageErrorsResponseOldest period first; in a period, the most frequent status code first.
data
object[]
required
data[].period
string
requiredThe start of the period in UTC, YYYY-MM-DD hh:mm:ss.
data[].status_code
string
requiredThe HTTP status code of the failed requests, for example 412.
data[].count
string
requiredFailed requests with this status code in the period. A decimal string, so a large count stays exact.
Example answer
{
  "data": [
    {
      "period": "2026-10-01 00:00:00",
      "status_code": "string",
      "count": "string"
    }
  ]
}

Errors

400

A date is missing or not valid, endDate is before startDate, or the range is too long.

401

The request has no credentials.

403

The request does not use Client Secret authentication.

429

Your account sent more calls this minute than its rate limit allows.