Invoices (Beta)

Invoice history endpoints

List invoices

get

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_idstring · uuidRequired

Responses

200

OK

application/json

idstringOptional

Invoice identifier

yearintegerOptional

Invoice year

monthintegerOptional

Invoice month (1-12)

invoice_datestring · dateOptional

Invoice date (first of the month)

total_cloud_billanyRead-onlyOptional

Total cloud provider bill across all providers, before applying any credits or enterprise discounts (AWS EDP/PPA, Azure MACC, GCP commit agreements).

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

500

Internal server error

application/json

default

Default error response

application/json

get

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

HTTPcURLJavaScriptPython

GET /beta/v1/org/{org_id}/invoices HTTP/1.1
Accept: */*

[
  {
    "id": "text",
    "year": 1,
    "month": 1,
    "invoice_date": "2026-05-16",
    "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
      }
    ]
  }
]

Get invoice by year and month

get

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_idstring · uuidRequired

yearintegerRequired

monthintegerRequired

Responses

200

OK

application/json

idstringOptional

Invoice identifier

yearintegerOptional

Invoice year

monthintegerOptional

Invoice month (1-12)

invoice_datestring · dateOptional

Invoice date (first of the month)

total_cloud_billanyRead-onlyOptional

Total cloud provider bill across all providers, before applying any credits or enterprise discounts (AWS EDP/PPA, Azure MACC, GCP commit agreements).

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

500

Internal server error

application/json

default

Default error response

application/json

get

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

HTTPcURLJavaScriptPython

GET /beta/v1/org/{org_id}/invoices/{year}/{month} HTTP/1.1
Accept: */*

{
  "id": "text",
  "year": 1,
  "month": 1,
  "invoice_date": "2026-05-16",
  "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
      }
    }
  ]
}

Get invoice line items

get

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

Path parameters

org_idstring · uuidRequired

yearintegerRequired

monthintegerRequired

Responses

200

OK

application/json

idstringOptional

Line item identifier

commitment_idstringOptional

Associated commitment identifier

utilizationnumberOptional

Average utilization for this commitment during the invoice period (0-1)

contract_termstring · enum · nullableOptional

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).

Possible values:

400

Bad request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not found

application/json

405

Method not allowed

application/json

409

Conflict

application/json

500

Internal server error

application/json

default

Default error response

application/json

get

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

HTTPcURLJavaScriptPython

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",
      "provider": "aws",
      "display_name": "text",
      "type": "text",
      "status": "active",
      "is_active": true,
      "is_archera_guaranteed": true,
      "account_id": "text",
      "billing_account_id": "text",
      "start_date": "2026-05-16T15:04:08.894Z",
      "end_date": "2026-05-16T15:04:08.894Z",
      "duration_seconds": 1,
      "guarantee_start": "2026-05-16T15:04:08.894Z",
      "guarantee_lockin_date": "2026-05-16T15:04:08.894Z",
      "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
    }
  }
]