Contazen API Documentation

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:

Parameter	Type	Default	Description
`page`	integer	1	Page number
`per_page`	integer	50	Items per page (max: 100)

Filtering

List endpoints typically support:

Parameter	Type	Description
`search`	string	Search term
`sort`	string	Sort field
`order`	string	Sort order (asc/desc)
`start_date`	string	Filter by date range
`end_date`	string	Filter 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

API Reference

API Reference

Overview

Base URL

Available Resources

Clients

Invoices

Products

Payments

Authentication

Request Format

Headers

Optional Headers

Response Format

Success Response

Error Response

Common Parameters

Filtering

Expanding

OpenAPI Specification

OpenAPI 3.0 Spec

Need Help?

Postman Collection

Support

​Overview

​Base URL

​Available Resources

Clients

Invoices

Products

Payments

​Authentication

​Request Format

​Headers

​Optional Headers

​Response Format

​Success Response

​Error Response

​Common Parameters

​Pagination

​Filtering

​Expanding

​OpenAPI Specification

OpenAPI 3.0 Spec

​Need Help?

Postman Collection

Support

Overview

Base URL

Available Resources

Authentication

Request Format

Headers

Optional Headers

Response Format

Success Response

Error Response

Common Parameters

Pagination

Filtering

Expanding

OpenAPI Specification

Need Help?