​
Overview

The Contazen API provides programmatic access to all features of the Contazen invoicing platform. This reference documents every endpoint, parameter, and response.

​
Base URL

All API endpoints are relative to: 
https://api.contazen.ro/v1

​
Available Resources

Clients

Manage your customers and business partners
  • List, search, and filter clients
  • Create B2B and B2C clients
  • Update client information
  • Track client history

Invoices

Create and manage invoices
  • Generate fiscal documents
  • Send invoices via email
  • Track payment status
  • E-Factura integration

Products

Manage your product catalog
  • Create products and services
  • Set pricing and VAT rates
  • Organize by categories
  • Track inventory

Payments

Process and track payments
  • Record payments
  • Generate receipts
  • Payment reconciliation
  • Payment reminders

​
Authentication

To test the API endpoints in this documentation, you need to add your API key in the Authorization field of the API playground. Enter it as: Bearer sk_live_YOUR_API_KEY

​
Request Format

​
Headers

All requests must include: 
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json

​
Optional Headers

Accept-Language: ro

​
Response Format

All responses follow this structure:

​
Success Response

{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "version": "v1",
    "response_time": "12.45ms"
  }
}

​
Error Response

{
  "success": false,
  "error": {
    "message": "Human-readable error message",
    "type": "error_type",
    "code": "error_code",
    "status": 400
  },
  "meta": {
    "version": "v1",
    "response_time": "12.5ms"
  }
}

​
Common Parameters

​
Pagination

Most list endpoints support pagination:
ParameterTypeDefaultDescription
pageinteger1Page number
per_pageinteger50Items per page (max: 100)

​
Filtering

List endpoints typically support:
ParameterTypeDescription
searchstringSearch term
sortstringSort field
orderstringSort order (asc/desc)
start_datestringFilter by date range
end_datestringFilter by date range

​
Expanding

Some endpoints support expanding nested objects: 
GET /api/v1/invoices/inv_123?expand[]=lines&expand[]=payments

​
OpenAPI Specification

Download our complete OpenAPI specification:

OpenAPI 3.0 Spec

Machine-readable API specification for code generation and testing

​
Need Help?

Postman Collection

Import our Postman collection for easy API testing

Support

Contact our support team for assistance