Usage - Diagrams.so

Current usage

GET /usage is free. It returns your plan, credits remaining, and cost estimates.

curl https://api.diagrams.so/api/v2/usage \
  -H "Authorization: Bearer dgz_live_YOUR_API_KEY"

Usage history

GET /usage/history is free. It returns an itemized, newest-first ledger of what each billable task charged, with the surface that ran it. It supports pagination and filters (action, source, diagram_id, since, until).

Response

{
  "items": [
    { "action": "generate", "credits": 1, "diagram_id": "d_1a2b3c", "source": "api", "created_at": "2026-07-30T..." },
    { "action": "edit",     "credits": 1, "diagram_id": "d_1a2b3c", "source": "mcp", "created_at": "2026-07-30T..." }
  ],
  "next_cursor": "...",
  "has_more": true
}

source is one of api, sdk-python, sdk-ts, mcp, or web, so you can see exactly where each charge came from.