API reference: Account and usage

Account and usage. Plan, AI replies used and the limit.

Read how many AI replies the account has used this billing period, so your systems can warn before the limit.

Studio Licht
Growth plan
This period
AI replies used1,240 / 2,000
Period started1 Oct 2026
TokenCRM sync

Get usage this billing period

GET/usage

The plan, the AI replies used in the current billing period and the plan's limit.

Permission: account:read

Request
curl https://get-api.simplyboost.io/api/v1/usage \
  -H "Authorization: Bearer $SIMPLYBOOST_TOKEN"

Response 200 OK

{
  "ok": true,
  "data": {
    "plan": "growth",
    "messagesUsed": 1240,
    "messageLimit": 2000,
    "periodStart": "2026-10-01T00:00:00+00:00"
  },
  "meta": { "requestId": "req_7c1e4b2a9f0d4e6c8b3a5d7f9e1c2b4a" }
}

Response fields

data.plan
string

trial, starter, growth, pro or enterprise.

data.messagesUsed
integer

AI replies used since periodStart.

data.messageLimit
integer

AI replies included in the plan per period.

data.periodStart
string (date-time)

When the current billing period began.

Errors

Only the common errors (see Responses and errors).

PreviousLimitsNextChatbots

Try SimplyBoost with your own content

Start a 7-day free trial with 100 AI replies. Add your website, install the widget and see how the agent answers your customers.

Start free trial
See pricing
  • No credit card required
  • 7 days, 100 AI replies
  • From €39 a month
  • Hosted in Europe