How do I generate a basic invoice PDF from JSON?

Send a POST to /api/v1/generate with your API key, the template id and a JSON body shaped like the sample on this page; DocuJSON renders the basic invoice and returns the PDF. The same template is callable from the DocuJSON MCP server inside Claude, Cursor or your own agent.

What data does the basic invoice template need?

The JSON body has 5 top-level keys: invoiceNumber, company, client, items, total.

Which designs does the basic invoice template come in?

Five, all free: base, ledger, instrument, rail, form. The same JSON body renders in all of them, so you can switch the design of your basic invoice without changing your integration.

Is the basic invoice template free?

Yes. Every template and every design is free, with a small DocuJSON watermark on the free plan. Pro removes the watermark, puts your logo where the DocuJSON mark sits in the basic invoice preview, and unlocks configurable variables and higher volume.

built-in · Invoice · Letter portrait

basic invoice template: json in, branded pdf out

Professional invoices in seconds

use this template →generate it from code all templates

five designs, one json body

base · Fraunces + Inter Tightuse this design →

the docujson house design: serif titles, clean tables, KPI cards, navy accents.

what's inside

the sections of the document, in reading order.

01Unique invoice ID
02Your company details
03Client details
04Line items
05Final total

the json body

5 keys

every key the document reads. send this shape, get the pdf.

invoiceNumberstringUnique invoice ID
companyobjectYour company detailsoptional
clientobjectClient details
itemsarrayLine items
totalnumberFinal totaloptional

built-in logic

This template's structure does the work: computed totals. Send the JSON; the engine lays it out in any of the five designs.

configurable outputs · pro

pro

one template. many outputs.

Set these once per template, in the workspace, no code. Every request then lays out by the rules you chose: the same data, a different document.

what this template can change

Tax label
Tax mode
Changes the maths: tax on top of the subtotal, folded into it, or left out.
Payment instructions

on every template

Signature blocks
Date format
Currency
Page orientation

configure it in the workspace →

the same data, three ways

tax mode: included in prices

tax mode: no tax

payment instructions: off

generate it from your code

01Pick a designChoose one of the five basic invoice designs; base and ledger are free.
02Send your JSONPOST a body shaped like the sample (invoiceNumber, company, client, items…) to /api/v1/generate with your API key, or call the template from the MCP server.
03Get the PDFDocuJSON renders the basic invoice with your logo and returns the PDF; the template id stays stable as you iterate.

This template is built in: call it with templateId "invoice-basic".

curl -X POST https://api.docujson.com/v1/generate \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "templateId": "invoice-basic", "data": { ... } }'

also: the `generate_pdf` tool on mcp.docujson.com, from Claude, Cursor or your own agent.

questions, answered

What is a basic invoice?: Professional invoices in seconds
How do I generate a basic invoice PDF from JSON?: Send a POST to /api/v1/generate with your API key, the template id and a JSON body shaped like the sample on this page; DocuJSON renders the basic invoice and returns the PDF. The same template is callable from the DocuJSON MCP server inside Claude, Cursor or your own agent.
What data does the basic invoice template need?: The JSON body has 5 top-level keys: invoiceNumber, company, client, items, total.
Which designs does the basic invoice template come in?: Five, all free: base, ledger, instrument, rail, form. The same JSON body renders in all of them, so you can switch the design of your basic invoice without changing your integration.
Is the basic invoice template free?: Yes. Every template and every design is free, with a small DocuJSON watermark on the free plan. Pro removes the watermark, puts your logo where the DocuJSON mark sits in the basic invoice preview, and unlocks configurable variables and higher volume.

your basic invoice, from json, in one call.

free to start. you land on this template when you sign up.

use this template →