Expenses API

Use the Expenses API to record and manage business spending.

Expense object

Field	Type	Description
id	string	Expense ID with the exp_ prefix.
category	string	Expense category.
description	string	Description.
amount	integer	Expense amount.
currency	string	ISO 4217 currency code.
vendor	string | null	Vendor or payee.
date	string	YYYY-MM-DD.
receipt_url	string | null	Receipt location.
created_by	string	User ID that created the record.
created_at	string	ISO 8601 timestamp.
updated_at	string	ISO 8601 timestamp.

Categories:

inventory, salary, rent, utilities, logistics, marketing, software, tax, other.

List expenses

GET /expenses

Filters: category, from, to, page, limit, sort, order.

Create an expense

POST /expenses

Required: category, description, amount, date.

curl -X POST https://api.cedius.app/v1/expenses   -H "Authorization: Bearer cedius_test_sk_example"   -H "Content-Type: application/json"   -d '{
    "category": "logistics",
    "description": "Delivery fuel",
    "amount": 25000,
    "date": "2026-09-09",
    "vendor": "TotalEnergies"
  }'

Retrieve an expense

GET /expenses/{expense_id}

Update an expense

PATCH /expenses/{expense_id}

Delete an expense

DELETE /expenses/{expense_id}

Successful deletion returns 204 No Content.

Validation

• amount must be greater than 0;
• category must use a supported value;
• date must be YYYY-MM-DD;
• description is required on creation.