curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Management API — Tokens & Usage
Usage by endpoint
GET /console/usage/by-endpoint/
GET
/
console
/
usage
/
by-endpoint
/
curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Returns request counts grouped by endpoint and HTTP method — useful for seeing which parts of the Management API an integration actually exercises. Lives on the regular Scanova API host (
qcg-api.scanova.io), authenticated with your dashboard OAuth access token.
Request
GET https://qcg-api.scanova.io/console/usage/by-endpoint/
Authorization: Bearer <your_oauth_access_token>
string
required
One of
sandbox, live, zapier, mcp. Selects which keys’ logs to aggregate.curl -G "https://qcg-api.scanova.io/console/usage/by-endpoint/" \
-H "Authorization: Bearer <your_oauth_access_token>" \
-d environment=live
[
{ "endpoint": "https://management.scanova.io/qr/", "method": "GET", "count": 2140, "error_rate": 0.004 },
{ "endpoint": "https://management.scanova.io/qr/", "method": "POST", "count": 318, "error_rate": 0.03 },
{ "endpoint": "https://management.scanova.io/qrcode/QR7K9M2XN/", "method": "PUT", "count": 96, "error_rate": 0.0 }
]
Response fields
The response is an array, one entry per distinct(endpoint, method) pair seen in the logs, sorted by count descending.
string
The full request URL that was logged, including the path parameter’s actual value (e.g. a specific
qrid) — not a normalized route template. Expect many distinct entries for path-parameterized routes if you’ve called them with different IDs.string
The HTTP method of the request, e.g.
GET, POST, PUT, DELETE.integer
Total requests logged for this endpoint/method pair.
number
Fraction (
0–1) of requests to this endpoint/method pair that returned a status code of 400 or above.Unlike Usage statistics and Daily usage, this endpoint has no
period/days window — it aggregates over the full log retention period (request logs are purged after 6 months).Errors
environment is required, same validation as Usage statistics.
Related
- Usage statistics — the same traffic as a single rolling-window total instead of a per-endpoint breakdown.
- Daily usage — the same traffic broken out by calendar day instead of by route.
- Management API overview — the
environmentvalues (sandbox,live,zapier,mcp) this endpoint aggregates by.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. management.scanova.io) — the same key sent to the regular API host will not authenticate.
Query Parameters
Response
200
Usage grouped by endpoint
Was this page helpful?
⌘I