VoiceDock Docs
ApiUsage

Get usage logs

Retrieve your organization's usage logs with billing information and optional date filtering.

GET
/usage

Retrieve your organization's usage logs with billing information and optional date filtering.

Authorization

BearerAuth
AuthorizationBearer <token>

API key authentication. Get your key from the dashboard.

In: header

Query Parameters

limit?integer

Maximum number of results (max 1000)

Default100
Rangevalue <= 1000
offset?integer

Number of results to skip

Default0
start_date?string

Filter usage from this date (ISO 8601)

Formatdate-time
end_date?string

Filter usage until this date (ISO 8601)

Formatdate-time

Response Body

application/json

application/json

curl -X GET "https://example.com/usage"
{
  "logs": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "duration_sec": 180,
      "byok_stt": false,
      "byok_llm": false,
      "byok_tts": false,
      "phone_number": "string",
      "agent_name": "string",
      "business_name": "string",
      "created_at": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 100,
    "offset": 0
  },
  "summary": {
    "total_calls": 42,
    "total_duration_seconds": 7560,
    "total_duration_minutes": 126
  }
}
{
  "error": "Invalid API key",
  "message": "string"
}