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:

{
  "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:

{
  "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.

Response: JSON object with service metadata.

GET /status

Status check – Returns current API health and operational status.

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:

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.

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:

Response: JSON object containing:

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

Pricing

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