Overview
The Invoice Generator API allows you to create professional PDF invoices with support for multiple languages, RTL layouts, and various design templates. Each API call consumes 1 credit.
Simple Pricing
1 credit per invoice generation
Multi-language
English, Arabic, French, Spanish, and more
RTL Support
Full Right-to-Left layout for Arabic
Professional Templates
Multiple design options
https://invovate.com/api(Production)http://localhost:8788/api(Development) Quick Start
Generate your first invoice in 3 simple steps:
Sign up at invovate.comand generate your API key in the dashboard
Save your invoice data as a JSON file (see examples below)
Authentication
All API requests require an API key for authentication. Include your API key in the Authorizationheader.
inv_sk_followed by a unique identifier. Credit System
Each successful PDF generation consumes 1 credit from your account balance.
Checking Your Credit Balance
Every API response includes your current credit balance:
Purchasing Credits
To purchase additional credits, visit invovate.comand navigate to the billing section.
Generate PDF Invoice
Generate a PDF invoice from JSON data. Consumes 1 credit on success.
Request Headers
Request Body
Send your invoice data as a JSON file or inline JSON object.
Request Format
Required Fields
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | Yes | Your company name |
| invno | string | Yes | Invoice number |
| date | string | Yes | Invoice date (YYYY-MM-DD) |
| to | string | Yes | Client address (multi-line) |
| currency | string | Yes | Currency code (USD, EUR, AED, etc.) |
| lang | string | Yes | Language code (en, ar, fr, es, etc.) |
| template | string | Yes | Template name (neat-pro, etc.) |
| rows | array | Yes | Array of line items |
Line Item Fields
| Field | Type | Required | Description |
|---|---|---|---|
| desc | string | Yes | Item description |
| qty | number/string | Yes | Quantity |
| rate | number/string | Yes | Unit price |
| disc | number/string | No | Discount percentage |
| tax | number/string | No | Tax percentage |
Optional Fields
| Field | Type | Description |
|---|---|---|
| due | string | Due date (YYYY-MM-DD) |
| po | string | Purchase order number |
| terms | string | Payment terms |
| ship | string | Shipping address |
| notes | string | Additional notes |
| refund | string | Refund policy |
| logo | string | Base64 encoded logo image |
| sig | string | Base64 encoded signature image |
| customLabels | object | Custom text labels for different languages |
Response Format
Success Response
Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Request success status |
| string | Base64 encoded PDF file | |
| credits.remaining | number | Your remaining credit balance |
| credits.used | number | Credits used in this call (always 1) |
| credits.userType | string | Always "api" for API calls |
| mode | string | Always "api" for API calls |
| metadata | object | Additional information about the generated PDF |
Error Handling
Error Response Format
Common Error Codes
| Error Code | HTTP Status | Description |
|---|---|---|
| API_KEY_REQUIRED | 401 | Missing API key in Authorization header |
| INVALID_API_KEY | 401 | Invalid or expired API key |
| EMAIL_VERIFICATION_REQUIRED | 403 | Account email not verified |
| INVALID_JSON | 400 | Invalid JSON in request body |
| INSUFFICIENT_CREDITS | 402 | Not enough credits to generate PDF |
| API_SECURITY_LIMIT_EXCEEDED | 429 | Rate limit exceeded |
| RENDER_ERROR | 400 | PDF generation failed |
| INTERNAL_ERROR | 500 | Internal server error |
Code Examples
English Invoice Example (invoice_en.json)
Arabic Invoice Example (invoice_ar.json)
cURL Command
JavaScript Example
Python Example
Supported Languages
| Language Code | Language | Direction |
|---|---|---|
en | English | LTR |
ar | Arabic | RTL |
ar-e | Eastern Arabic | RTL |
fr | French | LTR |
es | Spanish | LTR |
hi | Hindi | LTR |
pt | Portuguese | LTR |
Available Templates
| Template Name | Description |
|---|---|
neat-pro | Clean professional design |
modern-right | Right-aligned modern layout |
classic-left | Traditional left-aligned design |
elegant-gray-pro | Elegant gray color scheme |
band-blue-pro | Blue header band design |
cool-waves-pro | Modern wave pattern design |