Get turboclaw AI Platform API Call Statistics

Get the recent call count statistics for a specific API endpoint (grouped by HTTP status code). This is public statistics that reflect the total call volume and success rate of the API on the platform — not an individual user's call records (for personal records, please refer to Get turboclaw AI Platform API Call Records).

ℹ️ This interface belongs to the turboclaw AI Platform Management API, with a unified prefix of https://platform.turboclaw.cloud/api/v1/.

Interface Overview

Item Content
Method GET
URL https://platform.turboclaw.cloud/api/v1/apis/{api_id}/usage/
Authentication ❌ Public

Authentication Description

This interface is completely public, no account token or login state is required.

Path Parameters

Parameter Type Required Description
api_id UUID ✅ API ID (UUID format)

Request Example

cURL

curl 'https://platform.turboclaw.cloud/api/v1/apis/afc7917f-d89f-4dc9-95c2-863936b02cad/usage/' \
  -H 'accept: application/json'

Python

import requests

api_id = "afc7917f-d89f-4dc9-95c2-863936b02cad"
resp = requests.get(
    f"https://platform.turboclaw.cloud/api/v1/apis/{api_id}/usage/",
    headers={"accept": "application/json"},
    timeout=10,
)
items = resp.json()
if not items:
    print("No recent calls for this API")
else:
    total = sum(it["count"] for it in items)
    success = sum(it["count"] for it in items if 200 <= it["status_code"] < 300)
    print(f"Total calls: {total:,}")
    print(f"Success rate: {success / total:.1%}" if total else "")
    for it in items:
        print(f"  HTTP {it['status_code']:>3}: {it['count']:>8,}")

Node.js

const apiId = 'afc7917f-d89f-4dc9-95c2-863936b02cad'
const r = await fetch(`https://platform.turboclaw.cloud/api/v1/apis/${apiId}/usage/`)
const items = await r.json()
items.forEach((it) => console.log(`HTTP ${it.status_code}: ${it.count}`))

Response Example (HTTP 200)

When there are no call records:

[]

When there are calls:

[
  { "status_code": 200, "count": 12453 },
  { "status_code": 401, "count": 87 },
  { "status_code": 422, "count": 12 },
  { "status_code": 500, "count": 3 }
]

ℹ️ Note that this interface does not return paginated responses — it directly returns an array, without a count/items wrapper.

Response Field Description

Each record:

Field Type Description
status_code integer HTTP status code
count integer The number of occurrences of this status code recently (usually a rolling window of the past 7 days)

⚠️ The specific time window is controlled by the server and is not guaranteed. Do not use it as a stable API for billing or SLA reporting; it is only suitable for a "health overview."

Error Handling

HTTP Code Meaning
400 invalid api_id is not a valid UUID
404 not_found API does not exist

Practical Tips

  • To view your own call records, use Get turboclaw AI Platform API Call Records (with the ?user_id= parameter). This interface looks at the cumulative calls for the entire platform.
  • To create a status page: Poll this interface every minute to calculate the 2xx / 5xx ratio, which can roughly reflect the health status of the API. However, it is not true real-time monitoring and should only be used as a reference.
  • Status codes with count=0 will not be returned — so if the array only contains 200, it means that the API has not had any 4xx/5xx failures recently.