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"
},
"items": [
{
"id": 4201,
"line_index": 0,
"name": "Office supplies",
"description": null,
"quantity": 1,
"unit_code": null,
"unit_price": 200.00,
"vat_rate": 19,
"amount_wvat": 200.00,
"amount_vat": 38.00,
"amount": 238.00,
"category_id": null,
"product_id": null
}
],
"vat_breakdown": null,
"category_source": "manual",
"category_confidence": null,
"efactura": {
"supplier_invoice_id": "si_abc123",
"invoice_number": "119079",
"anaf_message_id": "4891234567",
"xml_available": true,
"pdf_available": true,
"pdf_url": "https://app.contazen.ro/api/v1/expenses/exp_abc123/efactura-pdf"
},
"created_at": "2024-01-15 10:30:00",
"updated_at": "2024-01-15 10:30:00"
}
}
Expenses
Retrieve Expense
Get detailed information about a specific expense by its CzUid
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"
},
"items": [
{
"id": 4201,
"line_index": 0,
"name": "Office supplies",
"description": null,
"quantity": 1,
"unit_code": null,
"unit_price": 200.00,
"vat_rate": 19,
"amount_wvat": 200.00,
"amount_vat": 38.00,
"amount": 238.00,
"category_id": null,
"product_id": null
}
],
"vat_breakdown": null,
"category_source": "manual",
"category_confidence": null,
"efactura": {
"supplier_invoice_id": "si_abc123",
"invoice_number": "119079",
"anaf_message_id": "4891234567",
"xml_available": true,
"pdf_available": true,
"pdf_url": "https://app.contazen.ro/api/v1/expenses/exp_abc123/efactura-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
The CzUid of the expense to retrieve
Query Parameters
Comma-separated list of related data to include in the response:
supplier- Include full supplier details instead of just the IDcategory- Include full category details instead of just the IDuser- Include user information for who created the expense
Response
Complete expense object with all details
Show Expense Object Properties
Show Expense Object Properties
Unique CzUid identifier for the expense
Reference number or invoice number
Detailed description of the expense
VAT percentage applied to the expense
Whether the original amount includes VAT
Expense date (YYYY-MM-DD)
Payment due date (YYYY-MM-DD)
Payment date (null if not paid)
Whether the expense has been paid
Current expense status:
paid, unpaid, overdue, or registeredSupplier CzUid (when not expanded)
Category ID (when not expanded)
User ID (when not expanded)
Line rows for the expense. Always at least one entry — legacy flat
expenses get a single synthesized line built from the header totals
so API consumers can render a uniform table.See Expense Lines & VAT Breakdown for the
full model.
Show Line Object
Show Line Object
Line row ID (0 for synthesized legacy lines)
Zero-based position
Display name
Optional detail
Line quantity
UN/ECE unit (e.g.
H87)Net unit price
VAT percent for this line
Line net (2dp,
quantity × unit_price rounded)Line VAT (2dp)
Line gross (2dp)
Per-line category override
Linked product CzUid
How the category was assigned:
ai (auto-classified), supplier
(inherited from the supplier’s default), or manual. null on
expenses without a category or legacy rows where provenance wasn’t
recorded.Auto-classifier confidence in the 0–1 range when
category_source === 'ai'. null otherwise.Populated when the expense was imported from the ANAF e-Factura SPV
inbox.
null for manually created expenses.Show Efactura Object
Show Efactura Object
CzUid of the linked supplier invoice
Supplier’s invoice number
ANAF e-Factura message identifier
Whether the e-Factura XML is stored on disk
Whether the PDF has already been generated
Bearer-authenticated URL that streams the e-Factura PDF (see Download e-Factura PDF)
When the expense was created
When the expense was last modified
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"
},
"items": [
{
"id": 4201,
"line_index": 0,
"name": "Office supplies",
"description": null,
"quantity": 1,
"unit_code": null,
"unit_price": 200.00,
"vat_rate": 19,
"amount_wvat": 200.00,
"amount_vat": 38.00,
"amount": 238.00,
"category_id": null,
"product_id": null
}
],
"vat_breakdown": null,
"category_source": "manual",
"category_confidence": null,
"efactura": {
"supplier_invoice_id": "si_abc123",
"invoice_number": "119079",
"anaf_message_id": "4891234567",
"xml_available": true,
"pdf_available": true,
"pdf_url": "https://app.contazen.ro/api/v1/expenses/exp_abc123/efactura-pdf"
},
"created_at": "2024-01-15 10:30:00",
"updated_at": "2024-01-15 10:30:00"
}
}
Authorizations
Use your API key (sk_live_xxx or sk_test_xxx)
Path Parameters
Expense CzUid
Query Parameters
Comma-separated list of relations to expand. Supported: supplier, category, user.
Was this page helpful?
⌘I