Skip to content
SimplyParse
All parsersGST & ACCOUNTS PAYABLE

GST Tax Invoice Parsing API

Prepare Indian GST invoice data for accounting and reconciliation. Edit the template’s fields and validation rules, then send documents through the API.

Use GST Tax Invoice Parser
EXAMPLE OUTPUT

Example output

This sample shows a selection of extracted data. Your API response uses the field names configured in your parser.

Supports PDFs, images (PNG, JPG, JPEG and WEBP), DOCX documents and Excel spreadsheets. Test your own samples to check the results for your documents and languages.

See the quickstart 
{
  "acknowledgement_date": "2026-09-14",
  "document_type": "GST invoice",
  "buyer_details": {
    "buyer_gstin": "27AAACD8836M1Z6",
    "place_of_supply": "Maharashtra",
    "place_of_supply_code": 27
  },
  "supplier_details": {
    "supplier_gstin": "27AABCS1234F1Z8"
  },
  "has_qr_code": false,
  "line_items": [
    {
      "gst_rate": 18,
      "hsn_sac_code": "7216",
      "taxable_value": 1000,
      "cgst_amount": 90,
      "sgst_amount": 90,
      "igst_amount": 0,
      "line_total": 1180
    }
  ],
  "totals": {
    "taxable_value_total": 1000,
    "cgst_total": 90,
    "sgst_total": 90,
    "igst_total": 0
  }
}
KEY FIELDS

Key fields

A preview of the template’s main fields and checks.

FIELDTYPEEXAMPLEVALIDATION
Supplier Details → Supplier GSTINstring27AABCS4721K1ZARequired · GSTIN format
Buyer Details → Buyer GSTINstring27AAACD8836M1Z6GSTIN format
Buyer Details → Place of SupplystringMaharashtraRequired
IRN IDstring251b7a7c34e5b89bd58afdae6bd24d6226003a4bbc2e4d1c8250ee48da9af776—
Line items → HSN_SAC Codestring271019Required
Line items → GST Ratenumber18Required
Totals → Taxable Value Totalnumber192770Required
Totals → CGST Totalnumber16744.8—
Totals → SGST Totalnumber16744.8—
Totals → IGST Totalnumber0—
More fields and editable rules are available in the app.View template in the app
Pay per page using prepaid credits. Check your parser’s rate in the app before processing.
CONNECT YOUR PARSER

API example

REQUEST
curl -X POST \
  "https://api.simplyparse.com/dapi/v1/parser/YOUR_PARSER_SLUG/parse" \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -F "file=@gst-invoice.pdf"
Replace the parser slug and token with yours.
EXAMPLE RESPONSE
{
  "status": "success",
  "code": "document_processed",
  "message": "Document processed successfully",
  "data": [
    {
      "document_id": "example-document",
      "status": "completed",
      "is_valid": true,
      "parsed_data": {
        "acknowledgement_date": "2026-09-14",
        "document_type": "GST invoice",
        "buyer_details": {
          "buyer_gstin": "27AAACD8836M1Z6",
          "place_of_supply": "Maharashtra",
          "place_of_supply_code": 27
        },
        "supplier_details": {
          "supplier_gstin": "27AABCS1234F1Z8"
        },
        "has_qr_code": false,
        "line_items": [
          {
            "gst_rate": 18,
            "hsn_sac_code": "7216",
            "taxable_value": 1000,
            "cgst_amount": 90,
            "sgst_amount": 90,
            "igst_amount": 0,
            "line_total": 1180
          }
        ],
        "totals": {
          "taxable_value_total": 1000,
          "cgst_total": 90,
          "sgst_total": 90,
          "igst_total": 0
        }
      },
      "validation_errors": []
    }
  ]
}
Standard HTTP requests. No SDK required.API quickstart
A FEW MORE DETAILS

Frequently asked
questions.

Read the quickstart
Can I customise the GST Tax Invoice Parser?

Yes. You define the field names, types, nested objects and arrays. Published templates are starting points that become private, editable copies in your account.

Does it capture IRN and e-invoice acknowledgement details?

The template includes IRN ID, acknowledgement number, acknowledgement date and a Has QR Code boolean. It also includes optional e-way bill, reverse-charge, IFSC, UPI and vehicle fields in its Conditional and Extras groups.

How are GSTINs validated?

Supplier GSTIN is required, and both supplier and buyer GSTINs must match the configured GSTIN pattern when supplied. This checks the format; it does not confirm registration status with the GST portal.

Which file formats can I use?

SimplyParse accepts PDFs, images (PNG, JPG, JPEG and WEBP), DOCX documents and Excel spreadsheets. Choose a template or define your own schema to extract structured JSON. Your parser also has a configurable maximum page limit.

How does billing work?

Your first 100 pages are free. Purchase-volume rates are $0.07 / ₹6 per page for Starter, $0.06 / ₹5 for Growth and $0.05 / ₹4 for Scale. Add prepaid credits from $10 or ₹500; credits remain valid for 3 months. Failed processing is not charged. Review your applicable rate in the app.

TRY IT ON YOUR OWN DOCUMENTS

Try your first
document.

Choose a template, upload a document and review the JSON.

Use the gst tax invoice template 100 free pages. No card required.