API Reference

All API requests require an API key sent via the `X-API-Key` header. Generate keys from your dashboard.

curl -H "X-API-Key: YOUR_KEY" https://api.innovo.taquora.com/v1/extract

Upload a PDF or image file to extract structured invoice data. Supports hospital bills, pharmacy invoices, and clinical billing documents.

curl -X POST https://api.innovo.taquora.com/v1/extract \
  -H "X-API-Key: YOUR_KEY" \
  -F "file=@invoice.pdf"

# Response
{
  "job_id": "abc-123-def",
  "status": "processing",
  "message": "Invoice queued for extraction"
}

Poll this endpoint to check extraction status. Once completed, the response includes the full structured data.

curl https://api.innovo.taquora.com/v1/jobs/abc-123-def \
  -H "X-API-Key: YOUR_KEY"

# Response (completed)
{
  "job_id": "abc-123-def",
  "status": "completed",
  "result": {
    "seller": { "name": "Apollo Pharmacy", "gstin": "27AAUFM7776R1ZS" },
    "buyer": { "name": "City Hospital" },
    "invoice_number": "INV-23841",
    "invoice_date": "2025-12-15",
    "line_items": [
      {
        "product_name": "Paracetamol 500mg",
        "hsn_code": "3004",
        "quantity": 100,
        "rate": 2.50,
        "amount": 250.00,
        "gst_percent": 12
      }
    ],
    "subtotal": 42891.00,
    "cgst": 2573.46,
    "sgst": 2573.46,
    "grand_total": 48037.92,
    "math_verified": true
  }
}

Retrieve a paginated list of your extraction jobs. Filter by status.

curl "https://api.innovo.taquora.com/v1/jobs?status=completed&limit=20" \
  -H "X-API-Key: YOUR_KEY"

Check your current credit balance and usage statistics.

curl https://api.innovo.taquora.com/v1/credits \
  -H "X-API-Key: YOUR_KEY"

# Response
{
  "balance": 142,
  "currency": "INR",
  "total_used": 358
}

Create, list, rotate, and revoke API keys programmatically.

# Create key
curl -X POST https://api.innovo.taquora.com/v1/keys \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "production"}'