Skip to main content
The Cloud Capital Public API gives you programmatic access to your cost insights data. You can query costs, apply filters, compare time periods, and manage saved filter configurations. Successful responses are JSON objects with "success": true and a "data" property containing the endpoint-specific payload. For most error status codes, the body is { "success": false, "error": { "message": "..." } }. HTTP 401 is an exception: missing or invalid credentials return { "message": "Unauthorized" } from the API gateway.

​
Base URL

All API requests are made to: 
https://api.cloudcapital.co/v1

​
Authentication

The API uses API key authentication. Include your key in the Authorization header as a Bearer token with every request. 
curl -X POST https://api.cloudcapital.co/v1/cost-insights/data \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filters":{"inclusions":{"dateRange":{"start":"2025-01-01","end":"2025-01-31"}}},"groupBy":{"dimension":"service","dateGrouping":"monthly"}}'

​
Creating an API key

1

Open settings

Navigate to Settings > API keys in your Cloud Capital dashboard.
2

Generate a key

Click Create API key, give it a descriptive name, and select the appropriate permissions.
3

Copy the key

Copy the generated key immediately. For security, the full key is only shown once.
Keep your API keys secure. Do not expose them in client-side code, public repositories, or logs.

​
Rate limits

API requests are rate-limited to protect service availability. When you exceed the limit, the API returns a 429 status code.
HeaderDescription
X-RateLimit-LimitMaximum requests per minute
X-RateLimit-RemainingRemaining requests in the current window
Retry-AfterSeconds to wait before retrying

​
Error handling

The API returns standard HTTP status codes. Application errors (for example validation failures) use the envelope below. 
{
  "success": false,
  "error": {
    "message": "Invalid request. Please see message details.. Invalid input: expected object, received undefined (at groupBy)"
  }
}
401 Unauthorized uses a different shape: 
{
  "message": "Unauthorized"
}
Status codeDescription
200Success (success: true and data payload)
400Invalid request parameters or body
401Missing or invalid API key
429Rate limit exceeded
500Server or upstream error (some operations may use this when a resource is missing or expired)

​
Next steps

Browse the Cost insights endpoints in the sidebar to start querying your data. Each endpoint page includes an interactive playground where you can send requests directly from the docs.