API Reference
API Reference / Endpoints / Platform

List public API usage logs

/v1/usage

List request logs for the authenticated workspace with optional filtering.

GET/v1/usage
Auth: API keyBilling: FreeBehavior: SyncScopes: analytics:read
GETSyncNo bodyanalytics:read

When to use it

Use this to build a developer-facing activity feed, reconcile recent calls, or verify that a key is exercising the routes you expect.

Behavior on success

Returns a completed payload on the normal success path.

Integration shape

Authorization model
analytics:read
Request format
No request body
Polling pattern
No polling required on the normal success path.

Request

FieldTypeRequiredDescription
pagenumberOptionalPagination page number.
limitnumberOptionalPage size, capped by the backend max limit.
service_categorystringOptionalOptional service filter such as music, speech, or sound-effects.
start_dateISO timestampOptionalOnly include usage created at or after this timestamp.
end_dateISO timestampOptionalOnly include usage created at or before this timestamp.

Example request

GET /v1/usage
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/usage?page=1&limit=20&service_category=music', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
  },
});

const payload = await response.json();
console.log(payload);

Example response

Response shapejson
{
  "success": true,
  "data": {
    "logs": [
      {
        "id": "log_123",
        "endpoint": "/v1/music/songs",
        "httpMethod": "POST",
        "statusCode": 202,
        "responseTimeMs": 812,
        "serviceCategory": "music",
        "serviceOperation": "songs",
        "creditsUsed": 1,
        "requestId": "req_123",
        "createdAt": "2026-05-12T12:00:00.000Z"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 1,
      "pages": 1
    }
  }
}

Implementation notes

This route is free and does not consume API call allowance.

Production guidance

Pair this route with idempotency on POST requests and either request polling or webhooks whenever the response is asynchronous.
Was this page helpful?
Previous
Request statusNext