Get All Invoices for One Organization
On this page
- OAuth 2.0 authentication for programmatic access to Cloud Manager is available as a Preview feature.
- The feature and the corresponding documentation might change at any time during the Preview period. To use OAuth 2.0 authentication, create a service account to use in your requests to the Cloud Manager Public API.
Base URL: https://cloud.mongodb.com/api/public/v1.0
Resource
GET /orgs/{ORG-ID}/invoices/
Request Path Parameters
Name | Type | Description |
---|---|---|
ORG-ID | string | Unique identifier of the organization. |
Request Query Parameters
The following query parameters are optional:
Name | Type | Necessity | Description | Default |
---|---|---|---|---|
pageNum | number | Optional | One-based integer that returns a subsection of results. | 1 |
itemsPerPage | number | Optional | Number of items to return per page, up to a maximum of 500. | 100 |
pretty | boolean | Optional | Flag that indicates whether the response body should be in a
prettyprint format. | false |
envelope | boolean | Optional | Flag that indicates whether or not to wrap the response in an envelope. Some API clients cannot access the HTTP response headers or
status code. To remediate this, set For endpoints that return a list of results, the | false |
backupJobsEnabledOnly | boolean | Optional | Flag indicating whether to exclude daemons not enabled for
backing up databases from the response. Set this to false to
include daemon configurations with the backupJobsEnabled
flag set to false . | true |
Request Body Parameters
This endpoint doesn't use HTTP request body parameters.
Response
Each document in the result
array represents one invoice.
Charges are typically posted the next day.
Name | Type | Description | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
amountBilledCents | number | Amount billed in this invoice, calculated as subtotalCents
+ salesTaxCents - startingBalanceCents . | ||||||||||||||||
amountPaidCents | number | Amount paid for this invoice, in USD cents. | ||||||||||||||||
created | string | Timestamp in ISO 8601 date
and time format in UTC when
this invoice was created. | ||||||||||||||||
creditsCents | number | Amount credited by MongoDB, in USD cents. | ||||||||||||||||
endDate | string | Timestamp in ISO 8601 date
and time format in UTC
when the billing period for this invoice ended. | ||||||||||||||||
id | string | Unique identifier for this invoice. | ||||||||||||||||
links | object array | One or more links to sub-resources and/or related resources. The relation-types between URLs are explained in the Web Linking Specification. | ||||||||||||||||
groupId | string | Unique identifier of the project with which the invoice is associated. Does not
appear on all invoices. | ||||||||||||||||
orgId | string | Unique identifier for the organization that received this
invoice. | ||||||||||||||||
salesTaxCents | number | Amount of taxes levied on subtotalCents. | ||||||||||||||||
startDate | string | Timestamp in ISO 8601 date
and time format in UTC of
the starting date for this invoice. | ||||||||||||||||
statusName | string | State of this invoice. Accepted values are:
| ||||||||||||||||
subtotalCents | number | Sum of all positive invoice line items in USD cents. | ||||||||||||||||
updated | string | Timestamp in ISO 8601 date
and time format in UTC when
the invoice was last updated. |
Example Request
curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \ --include \ --request GET "https://cloud.mongodb.com/api/public/v1.0/orgs/{ORG-ID}/invoices/?pretty=true"
Example Response
{ "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 }