Skip to main content
Developer Resources

Reading tenant cost

Praetorian finance viewers read tenant cost with GET /account/cost and a required from and to date range.

There is no customer cost-economics endpoint. GET /api/cost-economics/customer/{customer_id} is not a Guard route, and the Customer API does not accept customer_id, period, anchor_date, or date_range.

Praetorian finance viewers read tenant cost with the application route GET /account/cost. from and to are required, and both must be YYYY-MM-DD. Add series=true to return each daily snapshot in the range instead of one aggregate. A range with no stored cost data returns 404.

GET /account/cost?from=2026-06-01&to=2026-06-30

This route is not part of https://api.app.guard.praetorian.com/api/v1. It is limited to Praetorian users with the finance viewer role.