請求書の一覧
GET /api/v1/billing/invoices
組織の請求書を作成日時の新しい順にページネーションで返します。
認証：本エンドポイントはコンソールバックエンド API（Base URL
https://portal.aiin1.ai、api.portal.aiin1.aiではありません）に属します。コンソールアカウントでログインして取得したaccess_token（15 分間有効）が必要で、sk-nex-API トークンは使用できません。ログイン方法は 請求照合と使用量自動同期 を参照してください。
リクエストパラメータ
| パラメータ | 位置 | 型 | 必須 | 説明 |
|---|---|---|---|---|
start |
query | date | いいえ | 請求期間が [start, end] と重なる請求書のみ返却 |
end |
query | date | いいえ | 同上 |
page |
query | integer | いいえ | ページ番号（デフォルト 1） |
page_size |
query | integer | いいえ | 1 ページあたりの件数（デフォルト 20、最大 100） |
リクエスト例
curl "https://portal.aiin1.ai/api/v1/billing/invoices?start=2026-07-01&end=2026-07-31" \
-H "Authorization: Bearer $ACCESS_TOKEN"レスポンス
配列を返します。各行は 1 枚の請求書です：
| フィールド | 型 | 説明 |
|---|---|---|
id |
string(uuid) | 請求書 ID |
invoice_no |
string | 請求書番号 |
org_id |
string(uuid) | 組織 ID |
period_start / period_end |
date | 請求期間 |
total |
string(decimal) | 請求金額（USD） |
status |
string | 請求書の状態 |
due_date |
date | 支払期日 |
created_at |
string(datetime) | 作成日時 |
関連エンドポイント
GET /api/v1/billing/invoices/{id}— 請求書詳細（明細行を含む）GET /api/v1/billing/invoices/{id}/pdf— 請求書 PDF ダウンロードGET /api/v1/billing/ledger?page=&page_size=— 取引履歴（チャージ / 課金 / 調整）