Get usage

Returns the current billing period’s usage broken down by category.

GET /v1/billing/usage

Get usage

cURL

curl --request GET \
  --url https://api.vly.ai/v1/billing/usage \
  --header 'Authorization: Bearer <token>'

200

{
  "period_start": "2023-11-07T05:31:56Z",
  "period_end": "2023-11-07T05:31:56Z",
  "credits_used": 124,
  "credits_remaining": 376,
  "agent_runs": 42,
  "deployments": 18,
  "projects": 6
}

Returns credits used / remaining, agent runs, deployments, and active project count.

Hook this into your team dashboard to alert when usage approaches the cap. See Usage limits for thresholds.

Authorizations

Authorization · string · header · required

Workspace-scoped API key. Generate from Workspace settings → API keys.

Response

200 - application/json

OK

period_start · string<date-time>

period_end · string<date-time>

credits_used · integer

Example:

124

credits_remaining · integer

Example:

376

agent_runs · integer

Example:

42

deployments · integer

Example:

18

projects · integer

Example:

6