Costfluent Public API

Get commitment coverage

GET
https://api.costfluent.com
/v1/commitments/coverage
Bearer (API token)

Returns how much of the workspace's eligible usage commitments covered, the effective savings rate and the commitment left unused over a window, per bin and provider and in total, at amortized cost in the workspace's presentation currency.

Needs a token with viewCosts on the workspace.

Get commitment coverage › query Parameters

workspaceId
​WorkspacePublicId · pattern: ^wsp_[A-Za-z0-9_-]{2… · required
startDate
​string · date · required
endDate
​string · date · required
granularity
​string
Default: day
filter
​string | null

Get commitment coverage › Responses

Success

granularity
​DateBin · required
​CommitmentFiguresResponse[] · required
​CommitmentFiguresResponse[] · required
​CurrencyAmount[] · required
currency
​string | null · pattern: ^[A-Z]{3}$
historyFloor
​string | null · date

List commitments

GET
https://api.costfluent.com
/v1/commitments
Bearer (API token)

Returns the reservations, savings plans and committed use discounts held through the workspace's connections, narrowed to the accounts the workspace reads of each, by end date, earliest first and those without an end last. It holds at most 5,000: those still running, soonest end first, before those that have ended.

Needs a token with viewCosts on the workspace.

List commitments › query Parameters

workspaceId
​WorkspacePublicId · pattern: ^wsp_[A-Za-z0-9_-]{2… · required
provider
​string
status
​string
type
​string | null
service
​string | null
account
​string | null
region
​string | null
termYears
​integer | null · int32
paymentOption
​string | null
page
​integer · int32

The page to return, counted from 1. A page below 1 reads page 1; one past the last returns no items.

Default: 1
limit
​integer · int32

Items per page, from 1 to 100. A larger value is clamped to 100, a smaller one to 1.

Default: 20

List commitments › Responses

Success

​PaginationLinks · required
​CommitmentResponse[] · required