ドキュメント本文へスキップ
API

使用量の履歴を読む

1 日ごとの送信数と AI アクション、月ごとの従量課金の超過分の料金。

GET/billing/usage

実際の呼び出しをワークスペースに対して実行します。

GET /billing/usage

1 日ごとの送信数と AI アクション、月ごとの従量課金の超過分の料金。

例

billing:read が必要。days は 1 から 3,660 日前までさかのぼり、既定は 30。all はワークスペースが作られた日までさかのぼる。aiExtra は 1 日の枠を超え、従量課金で請求された AI アクションを数える。

curl
curl "$OE/billing/usage?days=7" -H "$AUTH"
レスポンス
{  "object": "usage_history",  "days": [    { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 },    { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 }  ],  "months": [    {      "month": "2026-09",      "extraSends": 3000,      "extraAiActions": 0,      "sendCents": 120,      "aiCents": 0,      "cents": 120    }  ],  "dailyAiActions": 150,  "monthlySends": 200000}

請求に届くのはワークスペースのオーナーだけ: API キー、またはオーナーがすべてのアドレスで接続したアクセストークン。メンバーのトークンは 403 owner_only、特定のアドレスやドメインに限定したキーやトークンは 422 capability_unsupported になる。

リファレンス