Contazen API Documentation

curl https://api.contazen.ro/v1/invoices/inv_9z8y7x6w5v \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "inv_9z8y7x6w5v",
    "object": "invoice",
    "number": "CTZ-2024-00123",
    "document_type": "fiscal",
    "date": "2024-03-15",
    "due_date": "2024-04-15",
    "client": {
      "id": "1a2b3c4d5e",
      "name": "Tech Solutions SRL",
      "cui": "RO98765432",
      "rc": "J40/5678/2021",
      "email": "contact@techsolutions.ro",
      "phone": "+40722334455",
      "address": "Bd. Tehnologie nr. 100",
      "city": "București, Sectorul 2",
      "county": "București",
      "country": "Romania",
      "bank": "BCR",
      "iban": "RO49AAAA1B31007593840000"
    },
    "lines": [
      {
        "id": "line_1",
        "description": "Web Development Services - March 2024",
        "quantity": 40,
        "unit": "ora",
        "price": 250.00,
        "vat_rate": 19,
        "subtotal": 10000.00,
        "vat_amount": 1900.00,
        "total": 11900.00
      },
      {
        "id": "line_2",
        "description": "Hosting and Maintenance",
        "quantity": 1,
        "unit": "buc",
        "price": 500.00,
        "vat_rate": 19,
        "subtotal": 500.00,
        "vat_amount": 95.00,
        "total": 595.00
      }
    ],
    "payments": [],
    "subtotal": 10500.00,
    "vat_amount": 1995.00,
    "total": 12495.00,
    "currency": "RON",
    "is_paid": false,
    "paid_amount": 0.00,
    "remaining_amount": 12495.00,
    "observations": "Payment terms: 30 days net",
    "created_at": 1710460800,
    "updated_at": 1710460800
  },
  "meta": {
    "version": "v1",
    "response_time": "34.56ms"
  }
}

GET

invoices

{id}

curl https://api.contazen.ro/v1/invoices/inv_9z8y7x6w5v \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "inv_9z8y7x6w5v",
    "object": "invoice",
    "number": "CTZ-2024-00123",
    "document_type": "fiscal",
    "date": "2024-03-15",
    "due_date": "2024-04-15",
    "client": {
      "id": "1a2b3c4d5e",
      "name": "Tech Solutions SRL",
      "cui": "RO98765432",
      "rc": "J40/5678/2021",
      "email": "contact@techsolutions.ro",
      "phone": "+40722334455",
      "address": "Bd. Tehnologie nr. 100",
      "city": "București, Sectorul 2",
      "county": "București",
      "country": "Romania",
      "bank": "BCR",
      "iban": "RO49AAAA1B31007593840000"
    },
    "lines": [
      {
        "id": "line_1",
        "description": "Web Development Services - March 2024",
        "quantity": 40,
        "unit": "ora",
        "price": 250.00,
        "vat_rate": 19,
        "subtotal": 10000.00,
        "vat_amount": 1900.00,
        "total": 11900.00
      },
      {
        "id": "line_2",
        "description": "Hosting and Maintenance",
        "quantity": 1,
        "unit": "buc",
        "price": 500.00,
        "vat_rate": 19,
        "subtotal": 500.00,
        "vat_amount": 95.00,
        "total": 595.00
      }
    ],
    "payments": [],
    "subtotal": 10500.00,
    "vat_amount": 1995.00,
    "total": 12495.00,
    "currency": "RON",
    "is_paid": false,
    "paid_amount": 0.00,
    "remaining_amount": 12495.00,
    "observations": "Payment terms: 30 days net",
    "created_at": 1710460800,
    "updated_at": 1710460800
  },
  "meta": {
    "version": "v1",
    "response_time": "34.56ms"
  }
}

Request

string

required

The invoice ID (ID) to retrieve

Default Expansions: When retrieving a single invoice, the lines and payments objects are automatically expanded by default. You don’t need to specify these in the expand parameter.

expand[]

array

Expand additional nested objects. See Expanding Objects for details.Available expansions:

lines - Invoice line items (already included by default)
payments - Payment records (already included by default)
client - Client details (optional)
efactura - E-Factura submission info (optional)

Invoice Status

Invoices can be in various states throughout their lifecycle. For a complete understanding of invoice states and transitions, see Invoice Lifecycle.

Quick Reference

Normal invoices: Regular active invoices
Draft invoices: Invoices not yet finalized (is_draft: true)
Voided invoices: Cancelled invoices that remain visible for audit purposes (status: "voided")
Deleted invoices: Completely removed from the system (return 404 errors)

Voided vs Deleted:

Voided invoices are marked as cancelled but remain accessible via API with status: "voided" for compliance and audit purposes
Deleted invoices are completely removed from the database and will return a 404 error

Response

success

boolean

Indicates if the request was successful

data

object

The invoice object

Show Invoice Object

string

Unique invoice identifier (ID)

object

string

Always invoice

number

string

Invoice number (e.g., “CTZ-2024-00001”)

document_type

string

Document type: fiscal, proforma, or receipt

status

string

Invoice statusPossible values:

draft - Invoice not yet finalized
issued - Invoice issued but not paid
paid - Invoice fully paid
overdue - Invoice past due date
voided - Invoice cancelled/voided (still visible for audit)

date

string

Invoice date (YYYY-MM-DD)

due_date

string

Due date (YYYY-MM-DD)

client

object

Client details (snapshot at time of invoice creation)

Show Client Snapshot

string

Client ID

name

string

Client name

cui

string

Tax ID (CUI/CIF)

string

Registration code

string

Email address

phone

string

Phone number

address

string

Street address

city

string

City

county

string

County

country

string

Country

bank

string

Bank name

iban

string

Bank account IBAN

lines

array

Invoice line items

Show Line Item

string

Line item ID

description

string

Product/service description

quantity

number

Quantity

unit

string

Unit of measure (e.g., “buc”, “ora”)

price

number

Unit price (without VAT)

vat_rate

number

VAT rate percentage

subtotal

number

Subtotal (quantity × price)

vat_amount

number

VAT amount

total

number

Total with VAT

payments

array

Payment records

Show Payment

string

Payment ID

amount

number

Payment amount

payment_date

string

Payment date (YYYY-MM-DD)

payment_method

string

Payment method

observations

string

Payment notes

subtotal

number

Subtotal before tax

vat_amount

number

Total VAT amount

total

number

Total amount including tax

currency

string

Currency code (e.g., “RON”)

is_paid

boolean

Payment status - true if fully paid

is_draft

boolean

Draft status - true if invoice is not finalized

is_voided

boolean

Voided status - true if invoice has been cancelled/voided

Voided invoices remain accessible for audit purposes

paid_amount

number

Total amount paid

remaining_amount

number

Remaining amount to be paid

observations

string

Invoice notes or observations

created_at

integer

Unix timestamp of creation

updated_at

integer

Unix timestamp of last update

meta

object

Response metadata including version and response time

curl https://api.contazen.ro/v1/invoices/inv_9z8y7x6w5v \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": "inv_9z8y7x6w5v",
    "object": "invoice",
    "number": "CTZ-2024-00123",
    "document_type": "fiscal",
    "date": "2024-03-15",
    "due_date": "2024-04-15",
    "client": {
      "id": "1a2b3c4d5e",
      "name": "Tech Solutions SRL",
      "cui": "RO98765432",
      "rc": "J40/5678/2021",
      "email": "contact@techsolutions.ro",
      "phone": "+40722334455",
      "address": "Bd. Tehnologie nr. 100",
      "city": "București, Sectorul 2",
      "county": "București",
      "country": "Romania",
      "bank": "BCR",
      "iban": "RO49AAAA1B31007593840000"
    },
    "lines": [
      {
        "id": "line_1",
        "description": "Web Development Services - March 2024",
        "quantity": 40,
        "unit": "ora",
        "price": 250.00,
        "vat_rate": 19,
        "subtotal": 10000.00,
        "vat_amount": 1900.00,
        "total": 11900.00
      },
      {
        "id": "line_2",
        "description": "Hosting and Maintenance",
        "quantity": 1,
        "unit": "buc",
        "price": 500.00,
        "vat_rate": 19,
        "subtotal": 500.00,
        "vat_amount": 95.00,
        "total": 595.00
      }
    ],
    "payments": [],
    "subtotal": 10500.00,
    "vat_amount": 1995.00,
    "total": 12495.00,
    "currency": "RON",
    "is_paid": false,
    "paid_amount": 0.00,
    "remaining_amount": 12495.00,
    "observations": "Payment terms: 30 days net",
    "created_at": 1710460800,
    "updated_at": 1710460800
  },
  "meta": {
    "version": "v1",
    "response_time": "34.56ms"
  }
}

Create Invoice Send Invoice

API Reference

Retrieve Invoice

Request

Invoice Status

Quick Reference

Response

API Reference

​Request

​Invoice Status

​Quick Reference

​Response

Request

Invoice Status

Quick Reference

Response