API reference
/
Billing and usage

Get API requests over time

GET/public/analytics/api-requests

Core + Managed TransfersAuthBasicDocsSession

The number of requests of your account in each period, split into succeeded and failed requests. Every request that the meter bills is here, failed requests included. 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

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

Response

200application/json · UsageApiRequestsResponseOne row for each period with requests, oldest first.

data

object[]

required

data[].period

string

requiredThe start of the period in UTC, YYYY-MM-DD hh:mm:ss.

data[].total_requests

string

requiredAll requests in the period. A decimal string, so a large count stays exact.

data[].success_requests

string

requiredRequests that succeeded. A decimal string, so a large count stays exact.

data[].error_requests

string

requiredRequests that failed. A decimal string, so a large count stays exact.

Example answer

{
  "data": [
    {
      "period": "2026-10-01 00:00:00",
      "total_requests": "string",
      "success_requests": "string",
      "error_requests": "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.