API Documentation

Access CloudCost Lite data via our REST API

Quick Start

Base URL

https://www.cloudcostlite.com/api

Authentication

Use API tokens in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Rate Limits

1000 requests per hour per API token

Available Endpoints

GET/api/budgets

Retrieve all budgets for your organization

Response: Array of budget objects with id, name, amount, period, etc.
GET/api/alerts

Retrieve all alerts for your organization

Query params: ?status=ACTIVE&severity=HIGH
GET/api/costs

Retrieve cost data for your organization

Query params: ?start=2024-01-01&end=2024-01-31&provider=AWS
GET/api/providers

Retrieve connected cloud providers

Getting Started

1. Create an API Token

Go to Settings → API Tokens and create a new token. Keep it secure!

2. Make your first request

curl -H "Authorization: Bearer YOUR_API_TOKEN" \ https://www.cloudcostlite.com/api/budgets

3. Explore the data

All endpoints return JSON responses. Check the response headers for rate limit information.

Error Handling

401Unauthorized - Invalid or missing API token
403Forbidden - Insufficient permissions
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong