Conversation Usage

Returns conversation and autonomy metrics, with breakdowns by platform, agent, channel, or tag.

GET https://api.platica.mx/v1/usage/conversations

Query 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	—
`breakdown`	enum	Breakdown dimension: `platform` (default), `agent`, `channel`, or `tag`	—

Response

{
  "workspaces": [
    {
      "id": "g6yCA16pkWl5eXo7KszB",
      "name": "My company",
      "billingPeriod": {
        "startDate": "2026-06-01T00:00:00.000Z",
        "endDate": "2026-06-30T23:59:59.999Z"
      },
      "conversations": {
        "range": {
          "startDate": "2026-06-01T00:00:00.000Z",
          "endDate": "2026-06-30T23:59:59.999Z"
        },
        "freshness": {
          "source": "daily_aggregations",
          "lastUpdated": "2026-06-29T18:00:05.000Z",
          "expectedLagMinutes": 60
        },
        "summary": {
          "conversationCount": 340,
          "assistedConversationCount": 28,
          "assistanceRequestCount": 35,
          "autonomyRate": 91.76
        },
        "breakdown": {
          "dimension": "platform",
          "totals": [
            { "key": "whatsapp", "label": "WhatsApp", "value": 300 }
          ],
          "series": [
            { "date": "2026-06-29T12:00:00.000Z", "key": "whatsapp", "label": "WhatsApp", "value": 40 }
          ]
        }
      }
    }
  ],
  "workspacesCount": 1
}

Response fields

Field	Description
`id`	Workspace ID
`name`	Workspace name
`billingPeriod`	Active billing period for the workspace
`conversations.range`	Effective date range evaluated
`conversations.summary.conversationCount`	Total conversations
`conversations.summary.assistedConversationCount`	Conversations that required human assistance
`conversations.summary.assistanceRequestCount`	Assistance requests recorded
`conversations.summary.autonomyRate`	Percentage of conversations resolved without human assistance
`conversations.breakdown.dimension`	Breakdown dimension applied
`conversations.breakdown.totals`	Per-key totals with `key`, `label`, and `value`
`conversations.breakdown.series`	Daily series per breakdown key
`conversations.freshness`	Latest update and expected lag

Nota

These metrics are computed from hourly aggregates, so they may lag by up to ~60 minutes. Check conversations.freshness for the latest update.

Previous Message Usage Next Usage Actors