Add New Expens

Production

https://{{subdomain}}.daftara.com/api2

POST

/expenses{format}

Create an expense.

The request body wraps the expense fields in an Expense object. Optionally include a JournalTransaction array to split the amount across chart-of-accounts accounts, a CostCenterTransaction array for cost-center allocation, and a RecurringExpense object to set up recurrence.

Only amount and date are required. Most other fields are optional and are defaulted automatically when omitted (see each field). Server-managed fields such as the record type, the recording staff member, and the status are set automatically and cannot be assigned from the request.

Idempotency: pass a unique unique_id to safely retry. If a previous request with the same unique_id already created an expense, the response echoes that expense (result = duplicated) instead of creating a duplicate.

Access: requires the account owner, or staff holding the Add New Expenses (or Draft) permission.

Request

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢202Accepted

application/json

The expense was created. When an idempotency unique_id matches a previous request, result is duplicated and the fields identify the already-existing expense.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftara.com/api2/expenses' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer ' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data '{
  "Expense": {
    "amount": 1500,
    "date": "2026-06-09",
    "currency_code": "EGP",
    "vendor": "AWS",
    "category": "Hosting",
    "note": "Monthly hosting"
  }
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 2415,
    "expense_number": "00051"
}

GET Single Expens

Edit Expenses