POST
/
clients
curl -X POST https://api.contazen.ro/v1/clients \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech Solutions SRL",
    "email": "contact@techsolutions.ro",
    "cui": "RO98765432",
    "rc": "J40/5678/2021",
    "phone": "+40722334455",
    "address": "Bd. Tehnologie nr. 45",
    "city": "București, Sectorul 2",
    "county": "București",
    "country": "RO",
    "postal_code": "020202",
    "iban": "RO49AAAA1B31007593840000",
    "bank": "BCR"
  }'

{
  "success": true,
  "data": {
    "id": "9z8y7x6w5v",
    "object": "client",
    "name": "Tech Solutions SRL",
    "email": "contact@techsolutions.ro",
    "phone": "+40722334455",
    "cui": "RO98765432",
    "rc": "J40/5678/2021",
    "client_type": "b2b",
    "address": "Bd. Tehnologie nr. 45",
    "city": "București, Sectorul 2",
    "county": "București",
    "country": "RO",
    "postal_code": "020202",
    "iban": "RO49AAAA1B31007593840000",
    "bank": "BCR",
    "contact_person": null,
    "created_at": 1704240000,
    "updated_at": 1704240000
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}

​
Request

​
name
string
required
Client name or company name
​
email
string
Email address
​
cui
string
Tax ID (CUI/CIF) - required for B2B clients
​
cui_prefix
string
default:"RO"
CUI prefix for international companies
​
rc
string
Registration code (e.g., J40/1234/2023)
​
phone
string
Phone number
​
address
string
Street address
​
city
string
City name. For București, include sector (e.g., “București, Sectorul 1”)
E-Factura Requirement: For Romanian e-invoicing compliance, București addresses must include the sector in the format “București, Sectorul X”
​
county
string
County or state
​
country
string
default:"RO"
Country code (ISO 3166-1 alpha-2)
​
postal_code
string
Postal or ZIP code
​
iban
string
Bank account IBAN
​
bank
string
Bank name
​
contact_person
string
Contact person name

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
The created client object
​
meta
object
Response metadata
curl -X POST https://api.contazen.ro/v1/clients \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech Solutions SRL",
    "email": "contact@techsolutions.ro",
    "cui": "RO98765432",
    "rc": "J40/5678/2021",
    "phone": "+40722334455",
    "address": "Bd. Tehnologie nr. 45",
    "city": "București, Sectorul 2",
    "county": "București",
    "country": "RO",
    "postal_code": "020202",
    "iban": "RO49AAAA1B31007593840000",
    "bank": "BCR"
  }'

{
  "success": true,
  "data": {
    "id": "9z8y7x6w5v",
    "object": "client",
    "name": "Tech Solutions SRL",
    "email": "contact@techsolutions.ro",
    "phone": "+40722334455",
    "cui": "RO98765432",
    "rc": "J40/5678/2021",
    "client_type": "b2b",
    "address": "Bd. Tehnologie nr. 45",
    "city": "București, Sectorul 2",
    "county": "București",
    "country": "RO",
    "postal_code": "020202",
    "iban": "RO49AAAA1B31007593840000",
    "bank": "BCR",
    "contact_person": null,
    "created_at": 1704240000,
    "updated_at": 1704240000
  },
  "meta": {
    "version": "v1",
    "response_time": "45.67ms"
  }
}