获取一个组织的所有发票

在此页面上

Resource

请求路径参数
请求查询参数
请求正文参数
响应
请求示例
响应示例

2024 年 8 月 30 日以后，Cloud Manager 将不再支持 MongoDB 3.6 和 4.0 的自动化、备份和监控。请升级您的 MongoDB 部署或迁移到 Atlas。

用于以编程访问权限Cloud Manager的 OAuth 2.0身份验证作为预览功能。: 在预览期间，功能和相应的文档可能随时更改。要使用 OAuth2.0 身份验证，请创建一个服务帐户，以便在向Cloud Manager Public API发出的请求中使用。

基本 URL： https://cloud.mongodb.com/api/public/v 1.0

Resource

GET /orgs/{ORG-ID}/invoices/

请求路径参数

名称	类型	说明
`ORG-ID`	字符串	组织的唯一标识符。

请求查询参数

以下查询参数为可选参数：

名称	类型	必要性	说明	默认
pageNum	数字	Optional	从一开始的整数，用于返回结果的一部分。	`1`
itemsPerPage	数字	Optional	每页要返回的项目数，最多 500 个。	`100`
pretty	布尔	Optional	指示响应正文是否应采用美观打印的标志格式。	`false`
envelope	布尔	Optional	指示是否将响应包装在信封中的标志。某些 API 客户端无法访问 HTTP 响应标头或状态代码。要修复此问题，在查询中设置 `envelope : true`。对于返回结果列表的端点，`content` 对象是一个信封。Cloud Manager 将 `status` 字段添加到响应正文。	`false`
backupJobsEnabledOnly	布尔	Optional	指示是否从响应中排除未启用备份数据库的守护进程的标志。将其设置为`false`以包含将`backupJobsEnabled`标志设置为`false`的守护进程配置。	`true`

请求正文参数

此端点不使用 HTTP 请求正文参数。

响应

result大量中的每个文档代表一张发票。费用通常在第二天公布。

名称

类型

说明

amountBilledCents

数字

此发票中的账单金额，计算公式为subtotalCents + salesTaxCents - startingBalanceCents 。

amountPaidCents

数字

为此发票支付的金额，以美分为单位。

created

字符串

ISO8601 格式的时间戳创建此发票时的日期和时间格式（ UTC 格式）。

creditsCents

数字

MongoDB 存入的金额，以美分为单位。

endDate

字符串

ISO8601 格式的时间戳此发票的计费周期结束时的日期和时间格式（ UTC 格式）。

id

字符串

此发票的唯一标识符。

links

对象数组

指向子资源和/或相关资源的一个或多个链接。 URL 之间的关系类型在 Web 链接规范中进行了解释。

groupId

字符串

与发票关联的项目的唯一标识符。 不会出现在所有发票上。

orgId

字符串

收到此发票的组织的唯一标识符。

salesTaxCents

数字

对subtotalCents征收的税额。

startDate

字符串

ISO8601 格式的时间戳此发票开始日期的日期和时间格式（ UTC 格式）。

statusName

字符串

此发票的状态。接受的值为：

状态	说明
`CLOSED`	订阅周期的所有费用均已确定，余额大于零，且尚未向客户收费。
`FAILED`	尝试从信用卡收取应付金额失败。
`FORGIVEN`	已向客户收费，但费用已被免除。
`FREE`	结果金额为零，因此不会向客户收取费用。
`PAID`	资金已转至 MongoDB, Inc.
`PENDING`	包括当前订阅周期的费用。处于这种状态的客户不应拥有多张发票。
`PREPAID`	该客户使用的是预付费计划，因此无需向客户付费。

subtotalCents

数字

所有正发票行项目的总和（以美元美分为单位）。

updated

字符串

ISO8601 格式的时间戳上次更新发票的日期和时间格式（ 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
}

后退

发票

来年

获取一个