Contazen API Documentation

curl -X GET "https://api.contazen.ro/v1/expenses/exp_abc123?expand=supplier,category,user" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "expense": {
    "id": "exp_abc123",
    "reference": "INV-2024-001",
    "description": "Office supplies purchase including paper, pens, and folders",
    "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",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu 123, Sector 1",
      "city": "Bucharest",
      "county": "Bucharest",
      "country": "Romania"
    },
    "category": {
      "id": 1,
      "name": "Office Expenses",
      "parent_id": null
    },
    "user": {
      "id": 1,
      "name": "John Doe"
    },
    "attachment": {
      "url": "https://api.contazen.ro/v1/files/download/att_def456",
      "type": "pdf"
    },
    "created_at": "2024-01-15 10:30:00",
    "updated_at": "2024-01-15 10:30:00"
  }
}

GET

expenses

{id}

curl -X GET "https://api.contazen.ro/v1/expenses/exp_abc123?expand=supplier,category,user" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "expense": {
    "id": "exp_abc123",
    "reference": "INV-2024-001",
    "description": "Office supplies purchase including paper, pens, and folders",
    "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",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu 123, Sector 1",
      "city": "Bucharest",
      "county": "Bucharest",
      "country": "Romania"
    },
    "category": {
      "id": 1,
      "name": "Office Expenses",
      "parent_id": null
    },
    "user": {
      "id": 1,
      "name": "John Doe"
    },
    "attachment": {
      "url": "https://api.contazen.ro/v1/files/download/att_def456",
      "type": "pdf"
    },
    "created_at": "2024-01-15 10:30:00",
    "updated_at": "2024-01-15 10:30:00"
  }
}

Overview

The Retrieve Expense endpoint allows you to get complete details about a specific expense record. You can optionally expand related data such as supplier information, category details, and user information.

Path Parameters

string

required

The CzUid of the expense to retrieve

Query Parameters

expand

string

Comma-separated list of related data to include in the response:

supplier - Include full supplier details instead of just the ID
category - Include full category details instead of just the ID
user - Include user information for who created the expense

Response

expense

object

Complete expense object with all details

Show Expense Object Properties

string

Unique CzUid identifier for the expense

reference

string

Reference number or invoice number

description

string

Detailed description of the expense

amount

object

Original expense amounts in the expense currency

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 in the 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 applied to the expense

with_vat

boolean

Whether the original amount includes VAT

date

string

Expense date (YYYY-MM-DD)

due_date

string

Payment due date (YYYY-MM-DD)

paid_date

string

Payment date (null if not paid)

is_paid

boolean

Whether the expense has been paid

payment_type

object

Payment type information (null if not paid)

Show Payment Type Object

integer

Payment type ID

name

string

Payment type name

status

string

Current expense status: paid, unpaid, overdue, or registered

supplier_id

string

Supplier CzUid (when not expanded)

supplier

object

Full supplier details (when expanded)

Show Supplier Object

string

Supplier CzUid

name

string

Supplier name

cui

string

Tax identification number

string

Trade register number

address

string

Address

city

string

City

county

string

County

country

string

Country

category_id

integer

Category ID (when not expanded)

Error Responses

404 Not Found

The expense with the specified ID does not exist or you don’t have access to it

curl -X GET "https://api.contazen.ro/v1/expenses/exp_abc123?expand=supplier,category,user" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "expense": {
    "id": "exp_abc123",
    "reference": "INV-2024-001",
    "description": "Office supplies purchase including paper, pens, and folders",
    "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",
      "rc": "J40/1234/2020",
      "address": "Str. Exemplu 123, Sector 1",
      "city": "Bucharest",
      "county": "Bucharest",
      "country": "Romania"
    },
    "category": {
      "id": 1,
      "name": "Office Expenses",
      "parent_id": null
    },
    "user": {
      "id": 1,
      "name": "John Doe"
    },
    "attachment": {
      "url": "https://api.contazen.ro/v1/files/download/att_def456",
      "type": "pdf"
    },
    "created_at": "2024-01-15 10:30:00",
    "updated_at": "2024-01-15 10:30:00"
  }
}

Authorizations

Authorization

string

header

required

Use your API key (sk_live_xxx or sk_test_xxx)

Path Parameters

string

required

Expense CzUid

Query Parameters

expand

string

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

Response

Expense details

success

boolean

data

object

Show child attributes

API Reference

​Overview

​Path Parameters

​Query Parameters

​Response

​Error Responses

Authorizations

Path Parameters

Query Parameters

Response

Overview

Path Parameters

Query Parameters

Response

Error Responses