API Reference

Usage & Logs

Query token usage, latency, and audit records programmatically from the management API.

Usage records

GET https://data.plurence.com/v1/usage

Returns per-request token counts, model, latency, and finish reason. Supports filter, sort, and pagination.

curl — last 100 requests for a project

curl "https://data.plurence.com/v1/usage?project_id=proj_...&limit=100&order_desc=timestamp" \
  -H "Authorization: Bearer YOUR_JWT"

response fields

timestamp	Unix ms. When the request completed.
model	Model used for the request.
provider	Provider that handled the request.
tokens.input	Input token count.
tokens.output	Output token count.
tokens.total	Total tokens billed.
latency_ms	Round-trip latency in milliseconds.
finish_reason	stop, max_tokens, error, etc.

GET https://data.plurence.com/v1/audit

Every gateway request — including auth failures, policy blocks, and errors — produces an audit event. Useful for security analysis and debugging.

curl — recent audit events

curl "https://data.plurence.com/v1/audit?limit=25&order_desc=timestamp" \
  -H "Authorization: Bearer YOUR_JWT"

See all query parameters and response schemas in the interactive API Explorer.