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
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-08-05T06:32:49.392Z",
    "owner": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "string"
    },
    "nextRenewalDate": null,
    "balance": null,
    "nextPayment": {
      "date": "2026-08-05",
      "amount": 1
    },
    "teams": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "string"
      }
    ]
  }
]

Success

Transactions

​
Transactions Operations

List transactions in a workspace

​
Query Parameters
  • from
    Type: string Format: date-time

    Fetch transactions that occurred after this date RFC 3339 timestamp

  • to
    Type: string Format: date-time

    Fetch transactions that occurred before this date RFC 3339 timestamp

  • applicationIds
    Type: array string[]

    Fetch transactions for these application IDs

  • offset
    Type: integer | null
    min:  
    0

    Offset for pagination

Responses
  • application/json
  • 401

    Missing or invalid API key

  • 403

    Insufficient privileges for this account

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

{
  "transactions": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "amount": -100.01,
      "currency": "EUR",
      "localAmount": -114.02,
      "localCurrency": "USD",
      "accountType": "application",
      "description": "string",
      "comment": "string",
      "application": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "string"
      },
      "authorizedAt": "2026-01-01T00:00:00Z",
      "settledAt": "2026-01-01T00:00:00Z",
      "type": "cardSend",
      "card": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "name": "Coffee Card",
        "type": "saasMain",
        "number": "1234",
        "owner": {
          "id": "123e4567-e89b-12d3-a456-426614174000",
          "name": "John Doe"
        },
        "status": "active",
        "tags": [
          "AI Expenses",
          "Variable Expenses"
        ]
      },
      "hasInvoice": true,
      "accounting": [
        {
          "field": {
            "id": "123e4567-e89b-12d3-a456-426614174000",
            "name": "string"
          },
          "value": "string",
          "name": "string"
        }
      ]
    }
  ],
  "nextOffset": null,
  "hasMore": true,
  "totalCount": 0
}

Success

Get the URL to download a transaction invoice

​
Path Parameters
  • transactionId
    Type: string Format: uuid
    required

    Transaction unique identifier

Responses
  • application/json
  • 401

    Missing or invalid API key

  • 403

    Insufficient privileges for this account

  • 404

    Record not found

Request Example for get/v0/transactions/{transactionId}/invoice-url
curl https://api.cledara.com/v0/transactions/123e4567-e89b-12d3-a456-426614174000/invoice-url \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "invoiceUrl": "https://example.com"
}

Success

Models