Usage Statistics
The usage statistics endpoints let you monitor Platica consumption from external systems: billing period, messages used, conversations, autonomy rate, message types, and the actors generating usage.
Available endpoints
| Method | Endpoint | Description |
|---|---|---|
GET | /v1/usage/period | Get the active billing period |
GET | /v1/usage/summary | Get a usage and autonomy summary |
GET | /v1/usage/messages | Query messages by type, channel, category, campaign, or status |
GET | /v1/usage/conversations | Query conversations, assistance, and autonomy |
GET | /v1/usage/actors | Query consumption by actor |
Data freshness
Messages are read from aggregates updated for every transaction. They expose two universes: total volume (all) and charged messages (billable), usually with a delay of seconds. Conversations and autonomy rate rely on hourly aggregates, so they may lag by up to ~60 minutes. Each response includes a freshness object with the latest available update.
Enterprise workspaces
For workspaces with billingType: "enterprise", Platica keeps credits (the workspace allotment) but omits creditsUsed and cost fields. Enterprise billing uses customer-specific rates, so monitoring uses total, billable, and non-billable counts. Enterprise always uses aggregates, even when mode=full is requested.