How do I generate a client 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 client 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 client invoice template need?

The JSON body has 8 top-level keys: invoiceNumber, issueDate, dueDate, client, items, totals, paymentTerms, notes.

Which designs does the client 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 client invoice without changing your integration.

Is the client 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 client invoice preview, and unlocks configurable variables and higher volume.

template · Finance · Letter portrait

client invoice template: json in, branded pdf out

Professional invoice with line items, tax, total, and payment notes.

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.

01invoice number
02issue date
03due date
04client
05items · 2 items
06totals
07payment terms
08notes

the json body

8 keys

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

invoiceNumberstringinvoice number
issueDatestringissue date
dueDatestringdue date
clientobjectclient
itemsarrayitems · 2 items
totalsobjecttotals
paymentTermsstringpayment terms
notesstringnotes

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 terms

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 terms: off

generate it from your code

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

Use this template in the builder, publish it, and you get a stable templateId for the API and the MCP server.

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

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

questions, answered

What is a client invoice?: Professional invoice with line items, tax, total, and payment notes.
How do I generate a client 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 client 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 client invoice template need?: The JSON body has 8 top-level keys: invoiceNumber, issueDate, dueDate, client, items, totals, paymentTerms, notes.
Which designs does the client 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 client invoice without changing your integration.
Is the client 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 client invoice preview, and unlocks configurable variables and higher volume.

other finance templates

all finance →

Budget vs. Actual

Finance variance review with department rollups and approvals.

Finance· 5 designs

Purchase Receipt

Payment receipt with itemized purchases, totals, method, and confirmation.

Finance· 5 designs

Employee Expense Report

Itemised list of reimbursable business expenses with category subtotals, advances and the amount owed back to the employee.

Finance· monthly· 5 designs

Monthly Profit & Loss Statement

Month-end income statement showing revenue, costs, gross profit, operating expenses and net income against the prior month and year to date.

Finance· monthly· 5 designs

Customer Statement of Account

Monthly summary of a customer's invoices, payments and credits with a running balance, aging and amount due.

Finance· monthly· 5 designs

Accounts Receivable Aging Report

Unpaid invoices by customer, bucketed by days past due, with the collections action for each account.

Finance· weekly· 5 designs

your client invoice, from json, in one call.

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

use this template →

template · Finance · Letter portrait

client invoice template: json in, branded pdf out

Professional invoice with line items, tax, total, and payment notes.

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.

01invoice number
02issue date
03due date
04client
05items · 2 items
06totals
07payment terms
08notes

the json body

8 keys

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

invoiceNumberstringinvoice number
issueDatestringissue date
dueDatestringdue date
clientobjectclient
itemsarrayitems · 2 items
totalsobjecttotals
paymentTermsstringpayment terms
notesstringnotes

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 terms

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 terms: off

generate it from your code

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

Use this template in the builder, publish it, and you get a stable templateId for the API and the MCP server.

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

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

questions, answered

What is a client invoice?: Professional invoice with line items, tax, total, and payment notes.
How do I generate a client 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 client 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 client invoice template need?: The JSON body has 8 top-level keys: invoiceNumber, issueDate, dueDate, client, items, totals, paymentTerms, notes.
Which designs does the client 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 client invoice without changing your integration.
Is the client 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 client invoice preview, and unlocks configurable variables and higher volume.

other finance templates

all finance →

Budget vs. Actual

Finance variance review with department rollups and approvals.

Finance· 5 designs

Purchase Receipt

Payment receipt with itemized purchases, totals, method, and confirmation.

Finance· 5 designs

Employee Expense Report

Itemised list of reimbursable business expenses with category subtotals, advances and the amount owed back to the employee.

Finance· monthly· 5 designs

Monthly Profit & Loss Statement

Month-end income statement showing revenue, costs, gross profit, operating expenses and net income against the prior month and year to date.

Finance· monthly· 5 designs

Customer Statement of Account

Monthly summary of a customer's invoices, payments and credits with a running balance, aging and amount due.

Finance· monthly· 5 designs

Accounts Receivable Aging Report

Unpaid invoices by customer, bucketed by days past due, with the collections action for each account.

Finance· weekly· 5 designs

your client invoice, from json, in one call.

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

use this template →