AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

1 つの組織のすべての請求書を取得

ベース URL: https://cloud.mongodb.com/api/public/v1.0

GET /orgs/{ORG-ID}/invoices/
名前
タイプ
説明

ORG-ID

string

組織の一意の識別子です。

次のクエリ パラメータは 任意です。

名前
タイプ
必要性
説明
default

pageNum

数値

任意

結果のサブセクションを返す 1 から始まる整数。

1

itemsPerPage

数値

任意

1 ページあたりに返す項目の数は最大 500 です。

100

pretty

ブール値

任意

レスポンス本体を pretty-print形式にするかどうかを示すフラグ。

false

envelope

ブール値

任意

応答をエンベロープでラップするかどうかを示すフラグ。

一部の API クライアントは、HTTP レスポンス ヘッダーまたはステータス コードにアクセスできません。これを修正するには、クエリで envelope : true を設定します。

結果のリストを返すエンドポイントの場合、 contentオブジェクトはエンベロープです。 Cloud Manager は、レスポンス本体にstatusフィールドを追加します。

false

backupJobsEnabledOnly

ブール値

任意

データベースのバックアップ用に有効になっていないデーモンを応答から除外するかどうかを示すフラグ。 これをfalseに設定し、 backupJobsEnabledフラグがfalseに設定されているデーモン構成を含めます。

true

このエンドポイントは、HTTP リクエスト本体パラメータを使用しません。

result配列内の各ドキュメントは 1 件の請求書を表します。 料金は通常翌日に表示されます。

名前
タイプ
説明

amountBilledCents

数値

この請求書の請求額は、 subtotalCents + salesTaxCents - startingBalanceCentsとして計算されます。

amountPaidCents

数値

この請求書の支払額(USD セント単位)。

created

string

この請求書が作成された国際標準化組織 (ISO) 8601のUTCでの日時形式のタイムスタンプ。

creditsCents

数値

MongoDB によってクレジットされた金額(USD セント単位)。

endDate

string

この請求書の請求期間が終了した時点のISO 8601形式の日付と時刻(UTC)。

id

string

この請求書のユニーク識別子。

links

オブジェクト配列

サブリソースや関連リソースへの 1 つ以上のリンク。URL 間の関係タイプについては、Web リンク仕様 で説明されています。

groupId

string

この請求書に関連付けられているプロジェクトの一意の識別子。すべてのインボイスに表示されるわけではありません。

orgId

string

この請求書を受信した組織の一意の識別子。

salesTaxCents

数値

subtotalCents に適用される税金額。

startDate

string

この請求書の開始日の ISO 8601 の日付と時刻形式の UTC タイムスタンプ。

statusName

string

この請求書の状態。 指定できる値は以下のとおりです。

  • CLOSED: サブスクリプションサイクルのすべての請求が確定され、残高がゼロを上回っており、かつカスタマーにはまだ請求が行われていません。

  • FAILED: 未払金額のクレジットカード請求が失敗しました。

  • FORGIVEN: カスタマーに請求が行われていますが、その請求は免除されています。

  • FREE: 金額がゼロであることが判明したため、カスタマーに請求はされません。

  • PAID: 資金は MongoDB, Inc. へ送金されました。

  • PENDING: 現在のサブスクリプション サイクルの料金が含まれます。カスタマーは、この状態で複数の請求書を持つべきではありません。

  • PREPAID: カスタマーは前払いプランを契約しているので、カスタマーには請求されません。

subtotalCents

数値

すべての正の請求書の明細項目を USD セント単位で合計します。

updated

string

請求書が最後に更新されたときの ISO 8601 の日付と時刻形式の UTC タイムスタンプ。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true"
{ "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true&pageNum=1&itemsPerPage=100", "rel" : "self" } ], "results" : [ { "amountBilledCents" : 0, "amountPaidCents" : 0, "created" : "2018-06-01T04:05:10Z", "endDate" : "2018-07-01T00:00:00Z", "id" : "{INVOICE-ID}", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}", "rel" : "self" } ], "orgId" : "{ORG-ID}", "salesTaxCents" : 0, "startDate" : "2018-06-01T00:00:00Z", "startingBalanceCents" : 0, "statusName" : "PENDING", "subtotalCents" : 0, "updated" : "2018-06-01T04:05:10Z" }, { "amountBilledCents" : 726, "amountPaidCents" : 726, "created" : "2018-02-01T06:05:04Z", "endDate" : "2018-03-01T00:00:00Z", "id" : "{INVOICE-ID}", "links" : [ { "href" : "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/{INVOICE-ID}", "rel" : "self" } ], "orgId" : "{ORG-ID}", "salesTaxCents" : 57, "startDate" : "2018-02-01T00:00:00Z", "startingBalanceCents" : 0, "statusName" : "PAID", "subtotalCents" : 669, "updated" : "2018-03-01T07:00:54Z" } ], "totalCount" : 16}