Overview#

Invoice Generator is a comprehensive invoice management API that enables businesses to create, customize, and distribute professional invoices programmatically. Built for e-commerce platforms, accounting systems, and billing automation, it supports multi-currency transactions, Indian GST/IGST compliance, and direct email distribution to customers.

The tool provides complete invoice lifecycle management—from generation with line-item details, tax calculations, and payment terms, to secure download and automated email delivery. It integrates seamlessly with SMTP servers for direct email transmission and maintains invoice records for later retrieval.

Ideal users include SaaS billing platforms, freelance management systems, accounting software providers, and e-commerce businesses requiring automated invoice workflows with professional formatting and compliance support.

Usage#

Generate an invoice for a consulting service with GST:

json

{
  "company": {
    "name": "TechCorp Solutions",
    "address": "123 Business Park",
    "city": "Bangalore",
    "state": "Karnataka",
    "pincode": "560001",
    "phone": "+91-80-XXXX-XXXX",
    "email": "billing@techcorp.com",
    "gstin": "18AABCT1234H1Z0",
    "pan": "AAACT1234H",
    "logo_url": "https://example.com/logo.png"
  },
  "customer": {
    "name": "Acme Corporation",
    "address": "456 Client Street",
    "city": "Mumbai",
    "state": "Maharashtra",
    "pincode": "400001",
    "phone": "+91-22-XXXX-XXXX",
    "email": "accounts@acme.com",
    "gstin": "27AABCT5678H1Z1"
  },
  "items": [
    {
      "description": "Consulting Services - Q1 2024",
      "quantity": 1,
      "rate": 50000,
      "tax_percent": 18
    },
    {
      "description": "Development Hours (120 hrs @ 500/hr)",
      "quantity": 120,
      "rate": 500,
      "tax_percent": 18
    }
  ],
  "invoice_number": "INV-2024-001",
  "invoice_date": "2024-01-15",
  "due_date": "2024-02-15",
  "payment_terms": "Net 30",
  "notes": "Thank you for your business. Payment via bank transfer preferred.",
  "bank_name": "HDFC Bank",
  "account_number": "1234567890123456",
  "ifsc_code": "HDFC0000123",
  "upi_id": "techcorp@hdfc",
  "is_igst": false
}

Sample Response:

json

{
  "invoice_id": "inv_7f8a9b2c1e5d3k4m",
  "status": "generated",
  "subtotal": 110000,
  "tax_amount": 19800,
  "total_amount": 129800,
  "created_at": "2024-01-15T10:30:45Z",
  "message": "Invoice generated successfully"
}

Endpoints#

GET /#

Root endpoint – Returns API information and health status.

ParameterTypeRequiredDescription———No parameters

Response: JSON object with service metadata.

---

GET /status#

Status check – Returns current API health and operational status.

ParameterTypeRequiredDescription———No parameters

Response: JSON object with status information and service uptime.

---

POST /generate#

Generate Invoice – Creates a new invoice from company, customer, and line item details.

Request Body:

FieldTypeRequiredDescriptioncompanyCompanyDetailsYesCompany/seller information including name, address, tax IDs, contact details, and optional logo URLcustomerCustomerDetailsYesCustomer/buyer information including name, address, tax IDs, and contact detailsitemsLineItem[]YesArray of line items with description, quantity, rate, and optional tax percentageinvoice_numberstringNoCustom invoice number (auto-generated if omitted)invoice_datestringNoInvoice issuance date in YYYY-MM-DD formatdue_datestringNoPayment due date in YYYY-MM-DD formatpayment_termsstringNoPayment terms description (default: "Due on Receipt")notesstringNoAdditional notes or payment instructionsbank_namestringNoBank name for payment detailsaccount_numberstringNoBank account numberifsc_codestringNoIFSC code for Indian bank transfersupi_idstringNoUPI ID for digital paymentsis_igstbooleanNoSet to true for IGST (Integrated GST), false for SGST+CGST (default: false)

Response: JSON object containing:

• invoice_id: Unique identifier for retrieving/downloading the invoice
• status: Generation status ("generated")
• subtotal: Total amount before tax
• tax_amount: Calculated tax amount
• total_amount: Final invoice total
• created_at: Timestamp of invoice creation

---

GET /download/{invoice_id}#

Download Invoice – Retrieves and downloads a previously generated invoice as PDF.

ParameterTypeRequiredDescriptioninvoice_idstringYesUnique identifier of the invoice to download (path parameter)

Response: PDF file download or JSON error with appropriate HTTP status.

---

POST /send-email#

Send Email – Sends a generated invoice to a specified email address via SMTP.

Request Body:

FieldTypeRequiredDescriptioninvoice_idstringYesUnique identifier of the invoice to emailto_emailstringYesRecipient email address (must be valid email format)to_namestringNoRecipient's display name (default: empty)from_emailstringYesSender email address (must be valid email format)from_namestringNoSender's display name (default: empty)subjectstringNoEmail subject line (default: empty)messagestringNoEmail body/message text (default: empty)smtp_hoststringNoSMTP server hostname (default: "localhost")smtp_portintegerNoSMTP server port number (default: 587)smtp_userstringNoSMTP authentication username (default: empty)smtp_passstringNoSMTP authentication password (default: empty)use_tlsbooleanNoEnable TLS encryption (default: true)

Response: JSON object containing:

• status: Email delivery status ("sent", "pending", or "failed")
• message: Status message with delivery details
• timestamp: Email send timestamp

---

Pricing#

PlanCalls/DayCalls/MonthPriceFree550FreeDeveloper20500$39/moProfessional2005,000$99/moEnterprise100,0001,000,000$299/mo

About#

ToolWeb.in - 200+ security APIs, CISSP & CISM, platforms: Pay-per-run, API Gateway, MCP Server, OpenClaw, RapidAPI, YouTube.

• toolweb.in
• portal.toolweb.in
• hub.toolweb.in
• toolweb.in/openclaw/
• rapidapi.com/user/mkrishna477
• youtube.com/@toolweb-009

References#

• Kong Route: https://api.toolweb.in/tools/invoicy
• API Docs: https://api.toolweb.in:8165/docs