Usage & Billing

GET/v1/usage

Returns your organization's current plan, usage statistics, and billing period.

Example

cURL

curl https://api.dokai.dev/v1/usage \
  -H "Authorization: Bearer dk_live_your_api_key"

Response

200 OK

{
  "plan": {
    "name": "Pro",
    "parse_quota": 5000,
    "data_retention_days": 30
  },
  "billing_period": {
    "start": "2026-03-01T00:00:00Z",
    "end": "2026-03-31T23:59:59Z"
  },
  "usage": {
    "parses_used": 1247,
    "parses_remaining": 3753,
    "percentage_used": 24.9
  }
}

Response fields

Field	Type	Description
`plan.name`	string	Current plan name
`plan.parse_quota`	integer	Monthly parse limit
`plan.data_retention_days`	integer	How long results are stored
`billing_period.start`	string	ISO 8601 billing period start
`billing_period.end`	string	ISO 8601 billing period end
`usage.parses_used`	integer	Parses consumed this billing period
`usage.parses_remaining`	integer	Parses left before hitting quota
`usage.percentage_used`	number	Quota consumption as a percentage

Note: Usage data updates in near real-time. The billing period resets automatically based on your subscription cycle. You can also view detailed usage breakdowns in the dashboard.