Contazen API Documentation

Overview

The List Expenses endpoint allows you to retrieve all expenses for your firm with advanced filtering, sorting, and pagination capabilities. You can filter by supplier, category, payment status, date ranges, and more.

Query Parameters

page

integer

default:"1"

Page number for pagination (minimum: 1)

per_page

integer

default:"50"

Number of items per page (minimum: 1, maximum: 100)

supplier_id

string

Filter by supplier using their CzUid

category_id

integer

Filter by expense category ID. If the category has subcategories, all subcategories will be included

status

string

Filter by payment status

paid - Expense has been paid
unpaid - Expense is not paid and not overdue
overdue - Expense is past its due date
registered - Expense is registered but not categorized as paid/unpaid

currency

string

Filter by currency code (e.g., RON, EUR, USD)

payment_type

integer

Filter by payment type ID (1-7):

1 - Cash
2 - Bank transfer
3 - Card
4 - Check
5 - Promissory note
6 - Other
7 - Compensation

start_date

string

Start date for filtering expenses (YYYY-MM-DD format)

end_date

string

End date for filtering expenses (YYYY-MM-DD format)

sort

string

default:"created_at"

Sort field:

created_at - Sort by creation date
date - Sort by expense date
due_date - Sort by due date
amount - Sort by amount

order

string

default:"desc"

Sort order:

asc - Ascending
desc - Descending

expand

string

Comma-separated list of related data to include:

supplier - Include full supplier details
category - Include full category details
user - Include user information

Response

expenses

array

Array of expense objects

Show Expense Object Properties

string

Unique CzUid identifier for the expense

reference

string

Reference number or invoice number

description

string

Expense description

amount

object

Original expense amounts

Show Amount Object

total

string

Total amount

without_vat

string

Amount without VAT

vat

string

VAT amount

currency

string

Currency code

account_amount

object

Accounting amounts (converted to firm’s base currency)

Show Account Amount Object

total

string

Total amount in base currency

without_vat

string

Amount without VAT in base currency

vat

string

VAT amount in base currency

currency

string

Base currency code

vat_percent

integer

VAT percentage

with_vat

boolean

Whether amount includes VAT

date

string

Expense date (YYYY-MM-DD)

due_date

string

Payment due date (YYYY-MM-DD)

paid_date

string

Payment date (if paid)

is_paid

boolean

Whether expense is paid

payment_type

object

Payment type information

status

string

Expense status (paid, unpaid, overdue, registered)

supplier_id

string

Supplier CzUid (when not expanded)

category_id

integer

Category ID (when not expanded)

user_id

integer

User ID (when not expanded)

created_at

string

Creation timestamp

updated_at

string

Last update timestamp

pagination

object

Pagination information

Show Pagination Object

totals

object

Summary totals for filtered expenses

Show Totals Object

amount

string

Total original amount

amount_without_vat

string

Total amount without VAT

vat

string

Total VAT amount

account_amount

string

Total amount in base currency

account_amount_without_vat

string

Total amount without VAT in base currency

account_vat

string

Total VAT in base currency

curl -X GET "https://api.contazen.ro/v1/expenses?page=1&per_page=20&status=unpaid&expand=supplier,category" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "expenses": [
    {
      "id": "exp_abc123",
      "reference": "INV-2024-001",
      "description": "Office supplies",
      "amount": {
        "total": "238.00",
        "without_vat": "200.00",
        "vat": "38.00",
        "currency": "RON"
      },
      "account_amount": {
        "total": "238.00",
        "without_vat": "200.00",
        "vat": "38.00",
        "currency": "RON"
      },
      "vat_percent": 19,
      "with_vat": true,
      "date": "2024-01-15",
      "due_date": "2024-02-15",
      "paid_date": null,
      "is_paid": false,
      "payment_type": null,
      "status": "unpaid",
      "supplier": {
        "id": "sup_xyz789",
        "name": "Office Depot SRL",
        "cui": "RO12345678",
        "address": "Str. Exemplu 123",
        "city": "Bucharest"
      },
      "category": {
        "id": 1,
        "name": "Office Expenses",
        "parent_id": null
      },
      "user_id": 1,
      "created_at": "2024-01-15 10:30:00",
      "updated_at": "2024-01-15 10:30:00"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 150,
    "total_pages": 8
  },
  "totals": {
    "amount": "15750.00",
    "amount_without_vat": "13235.29",
    "vat": "2514.71",
    "account_amount": "15750.00",
    "account_amount_without_vat": "13235.29",
    "account_vat": "2514.71"
  }
}

Authorizations

Authorization

string

header

required

Use your API key (sk_live_xxx or sk_test_xxx)

Query Parameters

page

integer

default:1

Page number

Required range: x >= 1

per_page

integer

default:50

Items per page

Required range: 1 <= x <= 100

supplier_id

string

Filter by supplier CzUid

category_id

integer

Filter by category ID

status

enum<string>

Filter by payment status

Available options:

paid,

unpaid,

overdue,

registered

currency

string

Filter by currency code

payment_type

integer

Filter by payment type: 1 = Cash 2 = Bank transfer 3 = Card 4 = Check 5 = Promissory note 6 = Other 7 = Compensation

Required range: 1 <= x <= 7

start_date

string<date>

Start date (YYYY-MM-DD)

end_date

string<date>

End date (YYYY-MM-DD)

min_amount

number

Minimum amount filter

max_amount

number

Maximum amount filter

string

Search in reference and description

sort

enum<string>

default:date

Sort field

Available options:

created_at,

date,

due_date,

amount

order

enum<string>

default:desc

Sort order

Available options:

asc,

desc

expand

string

Comma-separated list (supplier,category,user,attachment) - Note: attachment is singular as each expense supports only one attachment

Response

List of expenses

success

boolean

data

object

Show child attributes

API Reference

​Overview

​Query Parameters

​Response

Authorizations

Query Parameters

Response

Overview

Query Parameters

Response