v1
OpenAPI 3.1.0

Cledara API

The Cledara API gives you programmatic access to your Cledara workspace — applications, transactions, and more coming soon.

Authentication

All endpoints require an API key passed as a Bearer token: Authorization: Bearer <your-api-key>

API keys are managed in the Cledara web app under Profile → API Keys. Each key grants the same level of access as the user who created it.

Rate limits

Requests are limited to 120 per minute per API key. Every response includes the following headers:

Header Description
X-RateLimit-Limit Maximum requests allowed in the current window
X-RateLimit-Remaining Requests remaining in the current window
X-RateLimit-Reset Unix timestamp when the window resets

When the limit is exceeded the API responds with 429 Too Many Requests and an additional Retry-After header indicating how many seconds to wait before retrying.

Server:https://api.cledara.com
No authentication selected
Client Libraries
Shell Curl

Applications

​
Applications Operations

List applications in the workspace

​
Responses
  • application/json
  • 401

    Missing or invalid API key

  • 403

    Insufficient privileges for this account

Request Example for get/v0/applications
curl https://api.cledara.com/v0/applications \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

[
  {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "string",
    "status": "pending",
    "budget": {
      "type": "soft",
      "limit": null,
      "currency": "string",
      "periodicity": "week"
    },
    "createdAt": "2026-07-06T12:09:43.883Z",
    "owner": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string"
    },
    "nextRenewalDate": null,
    "balance": null,
    "nextPayment": {
      "date": "2026-07-06",
      "amount": 1
    }
  }
]

Success

Models