Speechbase

List request logs

Returns request log rows for the authenticated organization, ordered by timestamp (newest first). Mirrors the dashboard logs view. Logs are retained for 30 days. Pagination is cursor-based: pass `next_cursor` from one response back as `cursor` on the next call until `has_more` is `false`.

GET
/v1/logs

Returns request log rows for the authenticated organization, ordered by timestamp (newest first). Mirrors the dashboard logs view. Logs are retained for 30 days. Pagination is cursor-based: pass next_cursor from one response back as cursor on the next call until has_more is false.

Authorization

bearerAuth
AuthorizationBearer <token>

API key

In: header

Query Parameters

limit?integer

Maximum number of items to return. Defaults to 50, max 200.

Range1 <= value <= 200
cursor?string

Opaque pagination cursor. Pass back the next_cursor value from a previous response.

Length1 <= length
provider?string

Filter to a single provider (e.g. openai, elevenlabs).

Length1 <= length
status?integer

Filter to a single HTTP status code.

Range100 <= value <= 599
parent_request_id?string

Return only the per-turn child rows that belong to this conversation request.

Formatuuid
since?string

Inclusive lower bound on ts, in ISO 8601 (UTC).

Formatdate-time
until?string

Exclusive upper bound on ts, in ISO 8601 (UTC).

Formatdate-time

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/logs" \  -H "Authorization: Bearer $SPEECHBASE_API_KEY"
{
  "data": [
    {
      "request_id": "string",
      "parent_request_id": "string",
      "ts": "string",
      "path": "string",
      "status": 0,
      "provider": "string",
      "model": "string",
      "voice_id": "string",
      "voice_ref": "string",
      "char_count": 0,
      "latency_ms": 0,
      "error_code": "string",
      "error_detail": "string",
      "provider_options": "string",
      "moderation_decision": "string",
      "moderation_reason_type": "string",
      "moderation_reason_detail": "string",
      "moderation_confidence": 0,
      "moderation_latency_ms": 0
    }
  ],
  "next_cursor": "string",
  "has_more": true,
  "limit": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string"
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string"
}