API reference
/
Billing and usage

Get requests per endpoint

GET/public/analytics/top-routes

Core + Managed TransfersAuthBasicDocsSession

Your most called endpoints in the range, with their error rate and average response time. 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.

integrationType

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

limit

number · 20

The number of rows.

Response

200application/json · UsageTopRoutesResponseThe most called endpoint first.

data

object[]

required

data[].api_route

string

requiredThe endpoint, for example playlists.

data[].api_type

string

requiredThe kind of call, for example api or transfer.

data[].total_requests

string

requiredRequests to this endpoint. A decimal string, so a large count stays exact.

data[].error_count

string

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

data[].error_rate

number

requirederror_count / total_requests in percent, two decimals.

data[].avg_response_time_ms

number

requiredThe average response time in milliseconds.

Example answer

{
  "data": [
    {
      "api_route": "string",
      "api_type": "string",
      "total_requests": "string",
      "error_count": "string",
      "error_rate": 0,
      "avg_response_time_ms": 0
    }
  ]
}

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.