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 used messages by type, channel, category, or campaign |
GET | /v1/usage/conversations | Query conversations, assistance, and autonomy |
GET | /v1/usage/actors | Query consumption by actor |
Data freshness
Message usage is read from aggregates updated by each billable transaction, usually lagging by 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 relies on message and conversation counts.