Skip to main content
GET
/
v1
/
accounts
/
{account_id}
/
analytics
/
usage
Get usage analytics
curl --request GET \
  --url https://api.itellico.ai/v1/accounts/{account_id}/analytics/usage \
  --header 'X-API-Key: <api-key>'
{
  "meta": {
    "account_id": "<string>",
    "start": "2023-11-07T05:31:56Z",
    "end": "2023-11-07T05:31:56Z",
    "granularity": "hour",
    "group_by": [
      "agent"
    ],
    "tz": "UTC"
  },
  "data": [
    {
      "ts": "2023-11-07T05:31:56Z",
      "values": [
        {
          "seconds": 1,
          "conversations": 1,
          "dimensions": {}
        }
      ]
    }
  ]
}

Authorizations

X-API-Key
string
header
required

Path Parameters

account_id
string
required

Query Parameters

start
string<date-time> | null

Start timestamp (ISO-8601). Defaults to 30 days before end.

end
string<date-time> | null

End timestamp (ISO-8601). Defaults to now.

granularity
enum<string>
default:day

Bucket granularity for aggregation.

Available options:
hour,
day,
month
group_by
enum<string>[] | null

Dimensions to break results by (comma separated or repeated query params).

Available options:
agent,
subaccount,
type
tz
string | null

IANA timezone name used for bucket boundaries (default UTC).

limit
integer | null

Maximum number of time buckets to return (default 500).

Required range: 1 <= x <= 500

Response

200 - application/json

OK

Usage analytics response payload.

meta
UsageMetaSchema · object
required

Metadata describing the usage response.

data
UsageBucketSchema · object[]