Usage Actors
Returns message consumption grouped by actor: automatic agents, workspace users, contacts, or other buckets captured by Platica.
GET https://api.platica.mx/v1/usage/actorsQuery parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
workspace | string | Filters the response to one workspace. If omitted, returns all accessible workspaces | — |
startDate | string | ISO 8601 start date. If omitted, uses the start of the billing period | — |
endDate | string | ISO 8601 end date. If omitted, uses the end of the billing period | — |
Response
{
"workspaces": [
{
"id": "g6yCA16pkWl5eXo7KszB",
"name": "My company",
"billingPeriod": {
"startDate": "2026-06-01T00:00:00.000Z",
"endDate": "2026-06-30T23:59:59.999Z"
},
"actors": {
"range": {
"startDate": "2026-06-01T00:00:00.000Z",
"endDate": "2026-06-30T23:59:59.999Z"
},
"freshness": {
"source": "daily_aggregations",
"lastUpdated": "2026-06-29T18:31:10.000Z",
"expectedLagSeconds": 30
},
"actorTypes": [
{ "actorType": "Agente IA / automático", "messages": 870 },
{ "actorType": "Usuarios del workspace", "messages": 80 }
],
"workspaceUsers": [
{ "userId": "user_123", "email": "ana@example.com", "messages": 45 }
],
"summary": {
"totalMessages": 1200
}
}
}
],
"workspacesCount": 1
}Response fields
| Field | Description |
|---|---|
id | Workspace ID |
name | Workspace name |
billingPeriod | Active billing period for the workspace |
actors.range | Effective date range evaluated |
actors.actorTypes | Messages per actor type with actorType and messages |
actors.workspaceUsers | Messages per workspace user with userId, email, and messages |
actors.summary.totalMessages | Total messages used in the range |
actors.freshness | Latest update and expected lag |
Consejo
Use this endpoint to detect whether consumption comes mainly from automations, human users, or manually operated campaigns.