Invoices (Beta)
Invoice history endpoints
Returns all invoices for the organization, most recent first. Invoices are generated monthly once cloud provider bills are finalized and are the source of truth for Archera premiums and rebates. Per-term breakdowns are only included on the detail endpoint.
OK
Invoice identifier
Invoice year
Invoice month (1-12)
Invoice date (first of the month)
Total cloud provider bill across all providers, before applying any credits or enterprise discounts (AWS EDP/PPA, Azure MACC, GCP commit agreements).
Bad request
Unauthorized
Forbidden
Not found
Method not allowed
Conflict
Internal server error
Default error response
GET /beta/v1/org/{org_id}/invoices HTTP/1.1
Accept: */*
[
{
"id": "text",
"year": 1,
"month": 1,
"invoice_date": "2026-01-01",
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
},
"premium_billing": {
"charged": 1,
"list_price": 1,
"discount": {
"rate": 1,
"amount": 1
},
"credits_applied": 1
},
"total_cloud_bill": null,
"sections": [
{
"provider": "aws",
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
},
"premium_billing": {
"charged": 1,
"list_price": 1,
"discount": {
"rate": 1,
"amount": 1
},
"credits_applied": 1
},
"total_cloud_bill": 1
}
]
}
]Returns a single invoice for the specified year and month. Invoices are the source of truth for Archera fees and premiums charged during each billing cycle.
OK
Invoice identifier
Invoice year
Invoice month (1-12)
Invoice date (first of the month)
Total cloud provider bill across all providers, before applying any credits or enterprise discounts (AWS EDP/PPA, Azure MACC, GCP commit agreements).
Bad request
Unauthorized
Forbidden
Not found
Method not allowed
Conflict
Internal server error
Default error response
GET /beta/v1/org/{org_id}/invoices/{year}/{month} HTTP/1.1
Accept: */*
{
"id": "text",
"year": 1,
"month": 1,
"invoice_date": "2026-01-01",
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
},
"premium_billing": {
"charged": 1,
"list_price": 1,
"discount": {
"rate": 1,
"amount": 1
},
"credits_applied": 1
},
"total_cloud_bill": null,
"sections": [
{
"provider": "aws",
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
},
"premium_billing": {
"charged": 1,
"list_price": 1,
"discount": {
"rate": 1,
"amount": 1
},
"credits_applied": 1
},
"total_cloud_bill": 1,
"by_term": [
{
"label": "text",
"count": 1,
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
}
}
],
"by_type": [
{
"label": "text",
"count": 1,
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
}
}
]
}
],
"by_term": [
{
"label": "text",
"count": 1,
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
}
}
],
"by_type": [
{
"label": "text",
"count": 1,
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
}
}
]
}Returns all line items for the specified invoice, showing per-commitment charges, savings, premiums, and rebates.
OK
Line item identifier
Associated commitment identifier
Average utilization for this commitment during the invoice period (0-1)
Contract term of the commitment as it applied during this invoice's billing month — reflects the guarantee lock-in in effect at bill time. Prefer this over commitment.contract_term, which reflects the commitment's current term and may have shifted since (e.g. lock-in rolled over, guarantee changed).
Bad request
Unauthorized
Forbidden
Not found
Method not allowed
Conflict
Internal server error
Default error response
GET /beta/v1/org/{org_id}/invoices/{year}/{month}/line-items HTTP/1.1
Accept: */*
[
{
"id": "text",
"commitment_id": "text",
"commitment": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"provider_reservation_id": "text",
"order_id": null,
"provider": "aws",
"display_name": "text",
"guaranteed_display_name": "text",
"type": "text",
"status": "active",
"is_active": true,
"is_archera_guaranteed": true,
"account_id": "text",
"billing_account_id": "text",
"start_date": "2026-01-01T00:00:00.000Z",
"end_date": "2026-01-01T00:00:00.000Z",
"duration_seconds": 1,
"guarantee_start": "2026-01-01T00:00:00.000Z",
"guarantee_lockin_date": "2026-01-01T00:00:00.000Z",
"guarantee_method": null,
"region": "text",
"instance_type": "text",
"instance_family": "text",
"plan_type": "text",
"payment_option": "no_upfront",
"offering_class": "standard",
"is_flexible": true,
"instance_count": 1,
"contract_term": "one_year_gris"
},
"utilization": 1,
"contract_term": "one_year_gris",
"commitment_financials_invoice_month": {
"commitment_cost": {
"total": 1,
"breakdown": {
"cloud_provider_cost": {
"total": 1,
"breakdown": {
"recurring": 1,
"amortized_upfront": 1
}
},
"archera_premium": 1
}
},
"commitment_savings": {
"net": 1,
"gross": 1,
"rebate": 1
},
"covered_ondemand_cost": 1
}
}
]Last updated
Was this helpful?

