GST e Invoice JSON File Download: What It Is and Why You Can't Just Get One

A GST e invoice JSON file download isn't something a PDF tool can produce. It comes from a government e-invoicing portal, and it's tied to a registration number. Here's what it contains, how it's generated, and what to use if you're billing in the US.

By Invoala Editorial Team · Published 2026-11-20

Online payment form with credit card options displayed

A GST e invoice JSON file download is a machine-readable copy of an e-invoice, exported as a .json file from a government or government-approved e-invoicing portal after the invoice has been registered and assigned a reference number. You can't generate a valid one from a PDF tool or a word processor. It has to come from the system that issued the invoice number in the first place.

That's the short answer. If you searched this because you expected a "download JSON" button on a normal invoice generator, that button won't be there — and the reason is worth understanding, because it tells you which tool you actually need.

Key takeaways: A valid e-invoice JSON comes only from the registering portal; JSON holds line items, tax blocks, and a signed reference number; The US has no national GST e-invoicing; sales tax varies by state; Mismatched tax rates cause rejection before a reference number issues

What is a GST e invoice JSON file?

It's the data file behind an e-invoice — the same invoice you'd see as a PDF, but written as structured fields a computer can read.

A typical schema includes:

  • Supplier and recipient legal names, addresses, and tax registration numbers
  • The invoice number and the date of issue
  • Line items: description, quantity, unit price, discount, and tax rate per line
  • Tax totals broken out by rate band
  • The portal-assigned reference number and the acknowledgement date
  • A digital signature or checksum so the file can be verified as unaltered

GST-style e-invoicing exists in several countries, and each one publishes its own schema version and field list. India's model, for example, is well known, but Malaysia, Singapore, and others run their own systems with different field names and different thresholds. Never assume one country's schema works in another.

Two terms get used loosely and are worth separating:

TermWhat it meansWho issues it
e-invoice recordThe registered invoice on the portalThe government or approved portal
JSON exportA downloaded copy of that record's dataThe same portal, via a download or API
Plain invoice PDFA formatted documentAny invoicing tool or template

The JSON is a by-product of registration. No registration, no valid JSON.

person holding paper near pen and calculator

Photo by Kelly Sikkema on Unsplash

How to get a GST e invoice JSON file download

The steps below describe the general shape of the process. Exact menu labels, deadlines, filing forms, and turnover thresholds vary by country and by business category, so confirm them on your tax authority's own site before you rely on them.

  1. Confirm you're actually in scope. Most systems apply only above a turnover threshold, or only to certain buyer types (often business-to-business). Below the threshold, you typically bill normally and no JSON exists.
  2. Register on the official portal and complete any required onboarding or sandbox testing.
  3. Generate the invoice payload from your billing software, an approved third-party tool, or a portal form. This produces the upload file.
  4. Upload the payload and wait for validation. The portal checks the tax registration numbers and the arithmetic against its own records.
  5. Fix any rejection codes. Mismatched registration numbers and rate errors are the most common causes.
  6. Receive the reference number and acknowledgement. This is the moment the invoice legally exists in the system.
  7. Download the signed JSON and the human-readable PDF from the portal, and store both. Many regimes expect records to be retained for a set number of years.

If your software supports direct integration, steps 3 to 7 happen automatically. If not, you're doing manual uploads, which is where most errors creep in.

Ready to try it? Create a professional invoice in under two minutes with Invoala's free invoice generator, no sign-up and no watermark.

Example: what the JSON numbers look like

Say you're a supplier billing a registered business buyer for consulting work. The invoice is $2,400 before tax, with one line item, and the applicable rate on that service is 18%.

Here's roughly how the amounts fall out:

  • Taxable value: $2,400.00
  • Tax at 18%: $432.00
  • Invoice total: $2,832.00
  • Rounding adjustment: $0.00

In the JSON, you wouldn't see "$2,832.00" as a single string. You'd see a line item with quantity, unit price, and taxable amount; a tax block repeating the rate and the tax amount; and a total block summing them. The buyer's registration number and yours would each appear as their own field, and a reference number would be attached after the portal validated the file.

Now the same invoice where the tax rate is wrong. Say you declare 12% instead of 18%. The portal's tax on $2,400 becomes $288.00, a $144.00 gap against the $432.00 the portal expects. Validation fails, the file is rejected, and no reference number is issued. The invoice doesn't exist yet — no matter how clean the PDF looks.

That gap is the whole point of e-invoicing: the tax authority validates the arithmetic before the document counts.

a laptop computer sitting on top of a wooden desk

Photo by 2H Media on Unsplash

Common mistakes with e-invoice JSON files

  • Expecting a JSON export from a PDF generator. These are different documents. A PDF tool formats a page; it doesn't register anything.
  • Using a stale schema version. Portals update field lists. An old template that worked last year can fail silently or throw validation errors.
  • Editing the JSON by hand after download. The digital signature covers the content. Change a number and the file no longer verifies.
  • Mixing up the reference number and the invoice number. They're separate. Payers and portals often expect both.
  • Skipping the human-readable PDF. Many buyers still want a viewable document, and audits often ask for it alongside the data file.
  • Assuming the rules are the same everywhere. Thresholds, deadlines, and buyer categories differ by country — and in federal systems, sometimes by state or region. Check the official source for your jurisdiction rather than a blog post, including this one.

If you're invoicing from the United States

Here's the practical part. The US doesn't run a national GST e-invoicing regime. Sales tax is handled at the state level, and the rules differ by state — some states have no statewide sales tax, some tax services and some don't, and rates can vary within a state by locality. There's no federal portal that issues reference numbers or signed JSON.

So if you searched for a JSON download and you're billing US clients, you probably need a clean, correctly formatted invoice, not an e-invoice data file. Two things matter more than JSON:

  • Accurate tax lines at whatever rate applies where your customer is, if your state taxes what you sell.
  • A document your client can open and pay from without installing anything.

That's the job the free invoice generator is built for: fill a form, download an A4-accurate PDF, no sign-up and no watermark. If your client or a bookkeeper asks for the invoice as data rather than paper, check with them what format they actually need before you spend time on conversions.

How Invoala helps

Invoala doesn't issue GST e-invoices and won't produce a portal-signed JSON file. What it does is handle the invoice document itself, which is the part most US freelancers and small businesses actually need.

  1. Open the invoice generator and enter your business details and your client's. Nothing to install, no account.
  2. Add line items with descriptions, quantities, and rates. Add a tax line if your state taxes what you're selling.
  3. Check the totals and the invoice number, then download the PDF. It's laid out for A4, so it prints and fits the way a standard invoice should.
  4. Send it to your client and keep the file for your records.

From there, the follow-up work is where invoices usually stall. Payment tracking shows you which invoices are paid, due, or overdue, and automated reminder emails handle chasing so you're not writing "just following up" for the fourth time. If you're quoting before you bill, there's a free estimate generator too. Freelancers who want the workflow spelled out can read the step-by-step invoicing guide.

It's free to use, with no sign-up required to generate and download a PDF. Pricing details, including the optional upgrade, are on the pricing page.

What to do next

  • Billing inside a GST e-invoicing country? Go to your tax authority's official portal and use its schema and download flow. Confirm the current schema version and threshold there, not here.
  • Billing US clients? Skip the JSON hunt. Create the invoice, download the PDF, and send it.
  • Getting asked for a data file by a client? Ask them to name the exact format and version they can accept before you build anything.
  • Want a starting layout? Grab a free invoice template and adapt it to your line items.

The rule worth remembering: a valid e-invoice JSON comes from the system that registered the invoice. Everything else is just a document.

This article is general information, not tax, legal or financial advice. Rules, rates and deadlines vary by country and change over time. Check with your tax authority or a qualified professional before acting on anything here.

Frequently asked questions

Can I download a GST e invoice JSON file from a free invoice generator?

Generally no. A valid e-invoice JSON has to be exported from the government or approved portal that registered the invoice and assigned its reference number. A PDF generator can format the document, but it cannot register it or sign the data file.

What is inside an e-invoice JSON file?

Typically the supplier and buyer details including tax registration numbers, each line item with quantity and price, tax totals by rate, the portal reference number, and a digital signature. Exact field names depend on the schema version your country uses.

Do I need a GST e-invoice if I'm billing from the United States?

Not for a federal GST scheme, because the US doesn't have one. Sales tax is administered at the state level and rules vary by state, including whether services are taxed at all. Check your state's revenue department for what applies to you.

How do I make an A4 invoice without e-invoicing software?

Use a form-based generator and download the PDF. Invoala formats the output for A4, requires no sign-up, and adds no watermark, which covers most US freelancer and small business invoices that don't need portal registration.

Can I edit a JSON file after downloading it?

You can edit the text, but the file will usually stop validating. The digital signature covers the invoice content, so any change to amounts or identifiers breaks verification. Correct the invoice in the portal and download a fresh file instead.

Put it into practice

Create a professional invoice in under two minutes — free, no sign-up.

Create an invoice
GST e Invoice JSON File Download: What It Is | Invoala