The CloudFix API lets you read your own CloudFix data from code: recommendations, savings reports and account information. This page covers the read-only operations. Operations that change things are not described here yet.
Base URL
https://app.cloudfix.com/api/v3Get an API token
A signed-in person creates a token in the CloudFix app under API Tokens. Send it in the Authorization header as a bearer token. A token starts with cft_.
A token has a role, and it works with the lower of its own role and the role of the person who created it. The operations below need the Reader role.
- Reader can read recommendations, savings reports and account information.
- ResourceManager can do everything Reader can, and can also execute, cancel and snooze recommendations and create Jira and Zendesk tickets.
- RunbookManager can do everything ResourceManager can, and can also create a fixer’s runbooks in the tenant’s accounts.
Read-only operations
All of these need the Reader role.
| Method | Path | What it does |
|---|---|---|
| GET | /recommendations |
Lists recommendations |
| GET | /recommendations/export |
Returns up to 100 deduplicated recommendations matching your filters, with the total count and the list of finders |
| POST | /recommendations/export/download |
Creates a CSV of recommendations matching your filters and returns a download URL |
| GET | /recommendations/summary |
Summarizes recommendations, including potential savings and status |
| GET | /recommendations/summary-filters |
Returns the filters for organizational units, accounts, regions and tags |
| GET | /recommendations/report |
Returns the detailed report for one recommendation |
| GET | /report/savings |
Returns savings data |
| GET | /report/realized-savings |
Returns realized savings, including completed and actual amounts |
| GET | /savings/history |
Returns savings history |
| GET | /budget/alignment-data |
Returns budget limits, forecasted costs and variance for business units |
| GET | /settings/excluded-accounts |
Lists accounts excluded from onboarding, finder or fixer processes |
| GET | /settings/maintenance-windows/summary |
Counts configured maintenance windows |
| GET | /tenant/details |
Returns company name, registration status and ticket creation capability |
| GET | /organization/onboarding/stats |
Returns onboarding start date, completion status and template approval |
| GET | /stack-versions/latest |
Returns the latest stack version and its update status |
The full description, with parameters and response fields, is in openapi.json (OpenAPI 3.1).
MCP server
If you use an AI assistant, the CloudFix MCP server gives it read-only tools for recommendations, reports and EC2 pricing.
- Endpoint:
https://mcp.app.cloudfix.com/mcp - Transport: Streamable HTTP
- Access: read-only, with a CloudFix API token
More
- openapi.json: the API description
- pricing.json: plans and prices as data
- llms.txt: CloudFix for AI agents
- CloudFix API endpoint summary: further documentation in the help desk