Invoices (Beta) | API & MCP Reference | Archera

Invoice history endpoints

List invoices

`get/beta/v1/org/{org_id}/invoices`

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.

Path parameters

org_id: string · uuid (Required)

Responses

200 OK

{
  "id": "string",  
  "year": 2023,  
  "month": 10,  
  "invoice_date": "2023-10-01",  
  "commitment_financials_invoice_month": {},  
  "premium_billing": {},  
  "total_cloud_bill": null,  
  "sections": []
}

400 Bad request

401 Unauthorized

403 Forbidden

404 Not found

405 Method not allowed

409 Conflict

500 Internal server error

Get invoice by year and month

`get/beta/v1/org/{org_id}/invoices/{year}/{month}`

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.

Path parameters

org_id: string · uuid (Required)
year: integer (Required)
month: integer (Required)

Responses

200 OK

{
  "id": "string",  
  "year": 2023,  
  "month": 10,  
  "invoice_date": "2023-10-01",  
  "commitment_financials_invoice_month": {},  
  "premium_billing": {},  
  "total_cloud_bill": null,
  "sections": [],  
  "by_term": [],  
  "by_type": []  
}

400 Bad request

401 Unauthorized

403 Forbidden

404 Not found

405 Method not allowed

409 Conflict

500 Internal server error

Get invoice line items

`get/beta/v1/org/{org_id}/invoices/{year}/{month}/line-items`

Returns all line items for the specified invoice, showing per-commitment charges, savings, premiums, and rebates.

Path parameters

org_id: string · uuid (Required)
year: integer (Required)
month: integer (Required)

Responses

200 OK

[
  {
    "id": "string",  
    "commitment_id": "string",  
    "commitment": {},  
    "utilization": 0.75,
    "contract_term": "one_year_gris",
    "commitment_financials_invoice_month": {}
  }
]