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.

​
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 '{"startDate": "2025-01-01", "endDate": "2025-03-31"}'

​
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 and a consistent error response body. 
{
  "error": "BAD_REQUEST",
  "message": "Invalid request parameters",
  "details": [
    {
      "field": "startDate",
      "message": "startDate is required"
    }
  ]
}
Status codeDescription
200Success
201Resource created
400Invalid request parameters
401Missing or invalid API key
404Resource not found
429Rate limit exceeded