# Cloudflare の請求額、ついに API で丸わかりになったよ！

やっほー、しぃちゃんだよ！　今日はコストまわりのニュースだけど、地味に見えてすごく実用的な発表を見つけちゃったから紹介するね！

## なにが発表されたの？

Cloudflareのブログによると、アカウント単位で使える新しい「Billable Usage API」がリリースされたよ。単一のエンドポイントを叩くだけで、Workers、R2、D1、Workers AI、Vectorize、Images、Streamといった使用量ベースの自社プロダクトすべての利用状況と請求額を、プロダクト別・請求期間別にまとめて取得できるの。ブログでは「ダッシュボードは人間向けで、自動化には向いていない」というスタンスが明言されていて、今回のAPIはまさにその隙間を埋めるものなんだって。

このAPIはFOCUS（FinOps Open Cost and Usage Specification）という業界標準の命名規則に合わせて設計されているのもポイント。ブログには「AWS、Azure、Google Cloud、Oracle、そして増え続けるSaaS事業者がすでにFOCUS形式のエクスポートを公開している」と書かれていて、Cloudflareもこの流れに乗った形だね。ただし現時点では完全準拠ではなく、「仕様が要求する一部の列がまだペイロードに含まれていない」とはっきり書かれているよ。

## 今までどうだったの？

今までコストの可視化と言えば、Cloudflareのダッシュボード画面をスクリーンショットしたり、CSVをエクスポートして手作業でスプレッドシートに転記したりするのが定番だったみたい。財務チームやFinOpsチームは、複数のクラウドプロバイダを横断してコストを管理したくても、統一的なフォーマットで取得する手段がなかったの。開発者側から見ても、支出データをスクリプトに組み込んで自動でチェックする、といったことがしづらい状態だったんだよね。

## これで何が変わるの？

これからは、FinOpsチームや財務担当者がAPIを叩くだけで、他のクラウドプロバイダの支出データと同じような形式でCloudflareのコストを取り込めるようになるよ。チーム別のコスト割り当てや異常検知、さらにはAIエージェントを使ったFinOpsワークフローへの組み込みまで視野に入っているみたい。ブログでは実際にVantage社との統合も紹介されていて、読み取り専用のBilling Read権限トークンを使って日次でデータを取得し、他社クラウドの支出と同じダッシュボードで並べて見られるようになっているんだって。

開発者にとっても、月末を待たずにプログラムで支出の推移を追えるようになるのは嬉しいポイントだよね。

## 深く潜ってみよう

エンドポイントはこんな形になっているよ。

```bash
curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"
```

認証にはBilling Read権限を持つAPIトークンが必須で、`from`と`to`パラメータを指定すれば任意の日付範囲（例:2026-02-01から2026-02-15）に絞り込んで取得できるの。

レスポンスにはFOCUS準拠を意識した項目が並んでいて、`ServiceName`や`ServiceFamilyName`（プロダクト名・ファミリー名）、`ChargePeriodStart`/`ChargePeriodEnd`（請求期間）、`ConsumedQuantity`/`ConsumedUnit`（使用量・単位）、`ContractedCost`（請求額）、`CumulatedContractedCost`（累積額）などが含まれるよ。たとえば Workers Standard の使用量が150,000 GB-monthsで0.75ドルの請求になる、という具体例がブログに載っていたよ。

現時点での制限としては、使用量とコストのデータは「日次更新」で、リアルタイムのデータ提供はまだこれからとのこと。今回のリリースは自己サーブアカウント限定で、「Enterpriseの契約向けの同等の体験は現在開発中」ともはっきり書かれているの。今後はより細かい時間単位でのデータ提供や支出予測機能も予定されているみたい。

## まとめ

- Cloudflareが自己サーブアカウント向けに「Billable Usage API」を公開した
- 単一エンドポイントでWorkers、R2、D1などすべての使用量ベースプロダクトのコストと利用量をまとめて取得できる
- 業界標準のFOCUS仕様に沿った項目名を採用しているが、まだ完全準拠ではない
- データは現状日次更新で、Enterprise対応やリアルタイム化は今後の予定
- Vantageなどのツールと組み合わせれば、他社クラウドと横断したコスト管理もできる

Cloudflareを使っていて「支出を自動でチェックしたい」「FinOpsを自動化したい」と思っていた開発者やFinOpsチームには、まさに待望のアップデートだよ！
