Usage

Monitor your current billing period usage, quotas, and API request statistics.

Get usage statistics

GET/usage

Get usage statistics

Parameters

ParameterTypeRequiredDescription
X-Organization-IDstringOptionalSpecify organization context for multi-org users. If omitted, uses default org for API key.
curl -X GET https://logtalk.io/api/v1/usage \
-H "Authorization: Bearer lt_live_your_api_key_here" \
-H "Content-Type: application/json"

Examples

cURL

curl https://logtalk.io/api/v1/usage \
-H "Authorization: Bearer lt_live_your_key"

Node.js

const response = await fetch('https://logtalk.io/api/v1/usage', {
headers: {
'Authorization': `Bearer ${process.env.LOGTALK_API_KEY}`
}
});
const { data } = await response.json();
console.log(`Audio: ${data.audio.used}/${data.audio.quota}`);
console.log(`Video: ${data.video.used}/${data.video.quota}`);
console.log(`Credits available: ${data.credits.available}`);

Python

import requests
import os
response = requests.get(
'https://logtalk.io/api/v1/usage',
headers={'Authorization': f'Bearer {os.environ["LOGTALK_API_KEY"]}'}
)
data = response.json()['data']
print(f"Audio: {data['audio']['used']}/{data['audio']['quota']}")
print(f"Video: {data['video']['used']}/{data['video']['quota']}")
print(f"Credits: {data['credits']['available']}")

Response Fields

Billing Period

FieldTypeDescription
period_startstringStart of current billing period (ISO 8601)
period_endstringEnd of current billing period (ISO 8601)

Audio & Video Quotas

Video generation is coming soon — the video fields are present in the response today but will always report zero usage.

FieldTypeDescription
audio.quotaintegerMonthly audio episode limit
audio.usedintegerAudio episodes used this period
audio.remainingintegerRemaining audio episodes
video.quotaintegerMonthly video episode limit
video.usedintegerVideo episodes used this period
video.remainingintegerRemaining video episodes

Credits

FieldTypeDescription
credits.availableintegerTotal available credits (audio + video)
credits.audio_creditsintegerAudio episode credits available
credits.video_creditsintegerVideo episode credits available (coming soon)
credits.expiring_soonintegerCredits expiring within 30 days

API Requests

FieldTypeDescription
api_requests.todayintegerAPI requests made today (UTC)
api_requests.daily_limitintegerMaximum daily requests for your tier
api_requests.this_minuteintegerRequests made in the current minute
api_requests.minute_limitintegerMaximum requests per minute for your tier

Rate Limit Headers

All API responses include rate limit and quota information in headers, so you can monitor usage without polling GET /v1/usage on every request:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 455
X-RateLimit-Reset: 1705622400
X-RateLimit-Limit-Minute: 60
X-RateLimit-Remaining-Minute: 57
X-Quota-Audio-Limit: 10
X-Quota-Audio-Remaining: 3
X-Quota-Video-Limit: 5
X-Quota-Video-Remaining: 3
X-Quota-Reset: 2026-02-01T00:00:00Z
X-Quota-Credits-Available: 25
HeaderDescription
X-RateLimit-LimitYour daily request limit
X-RateLimit-RemainingRemaining requests today
X-RateLimit-ResetUnix timestamp when daily limit resets
X-RateLimit-Limit-MinuteYour per-minute request limit
X-RateLimit-Remaining-MinuteRemaining requests this minute
X-Quota-Audio-LimitMonthly audio episode limit
X-Quota-Audio-RemainingRemaining audio episodes
X-Quota-Video-LimitMonthly video episode limit (coming soon)
X-Quota-Video-RemainingRemaining video episodes (coming soon)
X-Quota-ResetISO 8601 timestamp for quota reset
X-Quota-Credits-AvailableAvailable credit balance