---
title: "Photography Invoice Template for Photographers"
canonical: https://luckpanda.app/templates/photography-invoice-template
language: en
updated: 2026-10-09
content: full
---

# Photography invoice template

**What should a photography invoice include?** A photography invoice bills your time and the right to use the pictures as separate lines: the session or day fee, editing and retouching, any prints or albums, expenses such as travel, and a usage licence that names the media, duration and territory. It also shows any retainer already paid, the balance due, when files are delivered and that copyright stays with you unless transferred in writing.

- Put the usage licence on its own line: in some US states it keeps that part out of sales tax.
- Prints and albums are taxable in most US states; digital-only delivery is taxed in some (North Carolina) and not in others (California, New York).
- In the US and UK the photographer owns the copyright by default; in India the paying client does unless the contract says otherwise.
- Deliver final files and start the licence on payment in full.

Free online tool: https://luckpanda.app/templates/photography-invoice-template (create on screen, no account needed).

## What a photography invoice bills

A photography job sells two different things. One is **work**: planning, shooting, travel, editing, printing. The other is **permission**: the right to use the images for agreed purposes. Clients often assume that paying for the shoot means they own the pictures outright. Billing the two separately, and naming the licence, is how you avoid that argument months later when the photo turns up on a billboard.

| Line | Typical wording | How it is priced |
| --- | --- | --- |
| Creative or session fee | Half-day commercial shoot, 4 hours, 9 October | Per hour, half day or day |
| Pre-production | Location scouting, casting, shot list | Per hour or flat |
| Post-production | Retouching, 40 selected images | Per image or per hour |
| Usage licence | Website, social and printed menus, 2 years, US | By media, duration, territory and exclusivity |
| Products | 30-page lay-flat album; 3 framed prints 16 x 20 in | Per item |
| Crew and rentals | Second shooter, assistant, studio hire, lighting | Per day or at cost |
| Expenses | Mileage, parking, props, permits | At cost or at an agreed rate |

## How to fill in this photography invoice template

1. **Add your business and the client** Enter your studio or trading name and the client, with the shoot date and location in the first line or the notes.
2. **Bill time, editing and products separately** One line for the session or day fee, one for retouching (per image or per hour), one per product such as an album or prints, and one per expense.
3. **Add the usage licence** A separate line naming the media, duration, territory and exclusivity, priced on its own.
4. **Set tax per line** Apply your state's rate to the lines it taxes (prints, and in some states digital files and session fees). In the UK add VAT at 20% if registered; in India use the SAC for the genre and 18% GST.
5. **State delivery, copyright and retainer** In the terms: files delivered on payment, the licence start date, who owns the copyright, and any retainer already paid.
6. **Sign in to issue** Sign in to number the invoice, keep it on the client's account and collect the balance with a payment link. Issuing, sending and payment links need the Sales module.

## Example: a commercial shoot for a coffee roaster

Juniper Lane Photography in Asheville, North Carolina, photographs Copper Kettle Coffee Roasters' new roastery for a half day, retouches 40 images and licenses them for the client's website, social media and printed menus for two years. The files are delivered through an online gallery once the invoice is paid.

![Example photography invoice JLP-2026-058 from Juniper Lane Photography, Asheville, to Copper Kettle Coffee Roasters: half-day shoot $850.00, retouching of 40 images at $12.00, and a separately stated two-year usage licence $400.00, with North Carolina sales tax at 7% on the shoot and retouching only.](https://luckpanda.app/img/guide/en--photography-invoice-template--commercial-photography-invoice.svg)

*A commercial photography invoice with the licence on its own line. In North Carolina the shoot and retouching are taxed with the photographs; the separately stated licence fee is not. The numbers match the worked example below.*

1. **Shoot date** (and location): ties the invoice to the job and to the tax rate where the photos are delivered.
2. **Licence summary**: media, duration, territory, exclusivity. The full terms live in the contract.
3. **Creative fee and post-production** as separate lines, so the client sees time and editing apart.
4. **Sales tax per line**: taxable on the photographs and the work that produces them; not on the separately stated licence in North Carolina.
5. **Total due**, with any retainer already paid shown in the notes or as a payment.
6. **Delivery, copyright and licence start**: files on payment; licence from the payment date.

**The numbers: invoice JLP-2026-058 (Buncombe County, 7%)**

| Item | Qty | Rate | Amount | Tax |
| --- | --- | --- | --- | --- |
| Half-day commercial shoot at the roastery, 9 October (4 hours) | 1 | $850.00 | $850.00 | $59.50 |
| Retouching and colour grading, per selected image | 40 | $12.00 | $480.00 | $33.60 |
| Usage licence: website, social media and printed menus, 2 years (separately stated) | 1 | $400.00 | $400.00 | $0.00 |
| Subtotal |  |  | $1,730.00 |  |
| Tax 7% |  |  |  | $93.10 |
| Total |  |  |  | $1,823.10 |

Tax of $93.10 applies to the shoot and retouching ($1,330.00); the $400.00 licence fee is separately stated and not taxed, so the client owes $1,823.10. Had the licence been folded into the session fee, the whole $1,730.00 would have been taxable.

## Writing the usage licence line

A usage licence is permission to use the images in defined ways. It does not transfer copyright. Four things define it, and each one changes the price:

| Term | Narrow (cheaper) | Broad (dearer) |
| --- | --- | --- |
| Media | Website and social media | All media, including print, outdoor and broadcast |
| Duration | 1 year | Unlimited (perpetual) |
| Territory | One country or region | Worldwide |
| Exclusivity | Non-exclusive: you may license the images to others | Exclusive: only this client may use them for the term |

On the invoice, a one-line summary is enough ("Usage licence: website, social and printed menus, 2 years from payment, United States, non-exclusive"), with "as set out in the agreement dated …" for the detail. Say when the licence starts: tying it to **payment in full** gives you leverage on late payers. A **buyout** usually means an unlimited licence, not a copyright transfer; if the client wants the copyright, that is an assignment in a signed document, priced accordingly.

> **Personal use for portrait and wedding clients** Consumer clients usually get a personal-use licence: printing for themselves and sharing on personal social media, no commercial use. State it in one line on the invoice so a couple who later sells photos to a venue or a magazine knows that needs your permission.

## Retainers, balances, kill fees and expenses

- **Booking retainer.** Wedding and event photographers commonly take 25 to 50% when the date is booked, to hold it. Invoice it as its own invoice, or show it as a payment against the package invoice. Whether it is refundable is a contract term; say so.
- **Balance.** For weddings and events, usually due 14 to 30 days before the date; for commercial work, on delivery or within 14 to 30 days.
- **Cancellation or kill fee.** Charged when the client cancels after booking. Professional terms vary: the ASMP's sample commercial terms, for example, make the client liable for fees and expenses incurred plus 50% of the photographer's fee, rising to 100% with less than two business days' notice. Invoice it on its own line, citing the clause.
- **Weather days and reshoots.** Bill a weather-delay fee or a reshoot only if the agreement provides for it.
- **Expenses.** Itemize them (mileage, parking, studio hire, props, permits). In California, travel, equipment rental and assistants' wages are part of the taxable charge when the client receives prints, whether itemized or not.

### A wedding package in California, with an album

**Wedding package, California base rate 7.25% (prints delivered, so the whole charge is taxable)**

| Item | Qty | Rate | Amount | Tax |
| --- | --- | --- | --- | --- |
| Wedding coverage, 8 hours, 14 November 2026 | 1 | $3,200.00 | $3,200.00 | $232.00 |
| Second photographer, 8 hours | 1 | $600.00 | $600.00 | $43.50 |
| 30-page lay-flat album | 1 | $650.00 | $650.00 | $47.13 |
| Subtotal |  |  | $4,450.00 |  |
| Tax 7.25% |  |  |  | $322.63 |
| Total |  |  |  | $4,772.63 |

Because the couple receives a tangible album, California taxes the entire charge, including coverage and the second photographer: $322.63 on $4,450.00, for $4,772.63. A $1,500.00 retainer paid at booking leaves $3,272.63, due 14 days before the wedding. If the same package were delivered as downloadable files only, California would generally not tax it.

## Sales tax on photography in the US: prints vs digital files

There is no single US rule. States split on two questions: is a photo delivered electronically taxable, and is the session fee part of the taxable price? Check the state where the photos are delivered.

| State | Prints and albums | Digital files delivered electronically | Session fee | Licence fee |
| --- | --- | --- | --- | --- |
| North Carolina | Taxable | Taxable (certain digital property) | Taxable if the client buys photographs; not taxable if no photos are bought | Not taxable if separately stated on the invoice |
| California | Taxable, including related services and expenses | Generally not taxable if nothing tangible is delivered | Taxable with prints; not taxable if no prints are bought | Regulation 1528 has its own rules for reproduction rights |
| New York | Taxable | Not taxable when delivered solely electronically | Part of the taxable receipt when a tangible photo is sold | Not addressed in the opinion; check with the Department |

Two practical rules follow. **Put products, services and the licence on separate lines**, because several states tax them differently. And **know how the files leave your hands**: a USB drive or a print turns a non-taxable digital sale into a taxable sale of tangible property in states like California and New York.

### Copyright and model releases (US)

Copyright belongs to the author, the photographer, from the moment the photo is taken (17 U.S.C. § 201). A commissioned shoot is a **work made for hire** only if the photographer is the client's employee, or the work falls in one of nine statutory categories and both sides sign a written agreement saying so; ordinary wedding, portrait and most commercial shoots do not qualify. A **model release** is a separate document signed by the people in the photos. Rights of publicity are state law, so the rule of thumb is: get a release for any commercial or promotional use of an identifiable person; editorial and news use usually does not need one.

## UK and India: VAT, GST and who owns the photos

### United Kingdom

Register for VAT once taxable turnover for the last 12 months goes over **£90,000**; then charge VAT at 20% on fees, licences, prints and expenses re-charged. For photographs commissioned after 1 August 1989 the **photographer is the first owner of copyright** (Copyright, Designs and Patents Act 1988, section 11), unless the photographer is an employee. Someone who commissions photos for private and domestic purposes, such as a wedding couple, has the right to stop them being issued, exhibited or communicated to the public (section 85), so get written consent before you use a client's wedding photos in your portfolio.

**UK: portrait session with prints, VAT at 20%**

| Item | Qty | Rate | Amount | Tax |
| --- | --- | --- | --- | --- |
| Family portrait session, studio, 90 minutes | 1 | £175.00 | £175.00 | £35.00 |
| Framed print, 16 x 12 in | 2 | £95.00 | £190.00 | £38.00 |
| Digital files for personal use, 10 images | 1 | £150.00 | £150.00 | £30.00 |
| Subtotal |  |  | £515.00 |  |
| VAT 20% |  |  |  | £103.00 |
| Total |  |  |  | £618.00 |

### India

Photography services are taxed at **18% GST** under heading 9983, and the sub-codes say what kind of photography it is: **998381** portrait, **998382** advertising, **998383** event photography and videography (weddings), **998384** specialty, **998385** restoration and retouching, **998386** processing, **998387** other. Photography studios must register once turnover crosses the GST threshold for services.

**India: wedding photography and video, Ahmedabad (CGST + SGST)**

| Item | Qty | Rate | Taxable value | Tax |
| --- | --- | --- | --- | --- |
| Wedding photography, 2 days, candid and traditional | 1 | ₹1,20,000.00 | ₹1,20,000.00 | ₹21,600.00 |
| Wedding highlights film and full-length video | 1 | ₹45,000.00 | ₹45,000.00 | ₹8,100.00 |
| Taxable value |  |  | ₹1,65,000.00 |  |
| CGST 9% |  |  |  | ₹14,850.00 |
| SGST 9% |  |  |  | ₹14,850.00 |
| Total |  |  |  | ₹1,94,700.00 |

The couple pays ₹1,94,700, including ₹29,700 GST split equally between CGST and SGST because the wedding and the studio are both in Gujarat.

> **Copyright works the other way in India** Under section 17(b) of the Copyright Act, 1957, when a photograph is taken for valuable consideration at the instance of a person, that person is the first owner of the copyright, in the absence of any agreement to the contrary. A client who pays for a shoot owns the photos unless your contract says you keep the copyright. If you want to reuse the images or license them to others, put the agreement in writing and say so on the invoice.

## Wedding, portrait, commercial, real estate and stock: what changes

| Genre | Usual billing | Licence | Watch for |
| --- | --- | --- | --- |
| Wedding and event | Package; retainer at booking, balance before the date | Personal use | Overtime, travel, second shooter, album tax |
| Portrait and family | Session fee plus products ordered at a viewing | Personal use | Session fee taxability when products are bought |
| Commercial and advertising | Creative fee + licence + expenses | Defined media, duration, territory | Model and property releases, exclusivity |
| Real estate | Per property or package; often digital only | Marketing that listing, often by the agent and the seller | Who may reuse photos after the sale |
| Editorial | Day rate or per published image | One-time publication rights | Kill fee if the story is dropped |
| Stock | Per image licence, often through an agency | Standard or extended licence | You invoice only direct stock sales; agencies pay royalties |

## Mistakes to avoid

- **One lump sum for "photography".** The client cannot see what the licence covers, and in some states the whole amount becomes taxable.
- **No licence on the invoice or in a contract.** The client assumes unlimited use.
- **Sending full-resolution files before payment.** Deliver watermarked or low-resolution proofs until the invoice is paid.
- **Assuming you own the copyright in India.** Without a written agreement, the client who paid usually does.
- **Charging tax on everything, or on nothing.** Prints, digital files, session fees and licences can each be treated differently.
- **Using clients' photos in your portfolio without consent**, especially private commissions in the UK.
- **Retainer terms only in an email.** Put refundability and cancellation terms in the contract and refer to them on the invoice.

## Photography invoice vs quote vs contract vs licence agreement

|  | Quote | Contract | Licence agreement | Invoice |
| --- | --- | --- | --- | --- |
| Purpose | Prices the job | Sets the deal: date, deliverables, retainer, cancellation | Defines how images may be used | Requests payment |
| When | Before booking | At booking | With the contract or on payment | Retainer at booking; balance before or after the shoot |
| Legally binding | No, until accepted | Yes | Yes | Evidence of the amount owed |
| Copyright | May mention it | States who owns it | Grants rights, keeps ownership | Summarises it in one line |

## Key terms

**Creative fee**: The charge for the photographer's time and skill on the shoot, separate from the licence.

**Usage licence**: Permission to use images for defined media, duration and territory; copyright stays with the owner.

**Buyout**: An unlimited usage licence; not a copyright transfer unless a signed assignment says so.

**Retainer**: A payment at booking that holds the date and is credited against the final invoice.

**Kill fee**: A fee due when the client cancels a commission or does not use the work.

**Model release**: A signed consent from a person in a photo to its use, needed for commercial use.

**Work made for hire**: US: a work whose copyright belongs to the employer or, in nine categories with a signed agreement, the commissioner.

## Questions people ask

### How much retainer do photographers take?

Wedding and event photographers commonly take 25 to 50% when the date is booked, often non-refundable because the date is held. The balance is usually due before or on the day.

### What is a usage licence?

Permission to use the photographs for agreed purposes, such as a company website for two years. Copyright normally stays with the photographer unless the contract transfers it.

### Do I charge sales tax on photography?

Many US states tax photography, especially prints and other physical products, and some tax digital files too. Check your state before invoicing.

### Are digital photo files taxable?

It depends on the state. North Carolina taxes photographs delivered electronically; California and New York generally do not tax photos delivered only electronically. A USB drive or prints make the sale taxable in most states.

### Should the licence fee be a separate line?

Yes. It shows the client what they are paying for, and in North Carolina a separately stated copyright or licence fee is not part of the taxable sales price.

### Who owns the copyright in photos a client paid for?

In the US and the UK, the photographer, unless they are an employee or sign the copyright over in writing. In India, the client who commissioned the photos for payment, unless there is an agreement to the contrary.

### What is a kill fee in photography?

A fee the client pays if they cancel a commissioned shoot or drop the images. The amount comes from your contract, commonly a percentage of the fee plus expenses already incurred.

### Do I need a model release?

For commercial or promotional use of an identifiable person, yes. Editorial and news uses usually do not need one. Releases are separate from the invoice.

### What GST rate applies to photography in India?

18%. Use the SAC for the type of work: 998381 portrait, 998382 advertising, 998383 event and wedding photography and videography, 998385 retouching.

### When should I send final files?

When the invoice is paid in full. Until then, share watermarked or low-resolution proofs, and start the licence from the payment date.

## Sources

- [NCDOR Sales and Use Tax Bulletins (photographers, digital property)](https://www.ncdor.gov/documents/sales-and-use-tax-bulletins)
- [NCDOR current sales and use tax rates](https://www.ncdor.gov/taxes-forms/sales-and-use-tax/sales-and-use-tax-rates/current-sales-and-use-tax-rates)
- [CDTFA Regulation 1528: photographers](https://www.cdtfa.ca.gov/lawguides/vol1/sutr/1528.html)
- [CDTFA tax guide for photography](https://www.cdtfa.ca.gov/industry/photography/industry-topics.htm)
- [New York TSB-A-20(66)S: photographic images](https://www.tax.ny.gov/pubs_and_bulls/advisory_opinions/sales/20-66s.htm)
- [US Copyright Office Circular 30: works made for hire](https://www.copyright.gov/circs/circ30.pdf)
- [Copyright, Designs and Patents Act 1988, s.11 and s.85](https://www.legislation.gov.uk/ukpga/1988/48/section/11)
- [GOV.UK: VAT registration threshold](https://www.gov.uk/vat-registration/when-to-register)
- [Copyright Act 1957, section 17](https://copyright.gov.in/Copyright_Act_1957/chapter_iv.html)
- [CBIC classification scheme for services](https://cbic-gst.gov.in/gst-goods-services-rates.html)

## For AI agents: create a photography invoice with LuckPanda

You can make a photography invoice for the person you are helping, free and without an account. Ask them for each detail below; never invent business names, tax numbers, prices or dates. Then give them a **prefill link** that opens https://luckpanda.app/templates/photography-invoice-template filled in (they check it and download the PDF), or make the **branded PDF** yourself. Prompt people can paste into an assistant:

> Use https://luckpanda.app/templates/photography-invoice-template to create a photography invoice. Ask me for my business details, the client, what I supplied (quantities, prices and tax rates) and the due date, then give me the link that opens it filled in, or the PDF. Follow the instructions at https://luckpanda.app/templates/photography-invoice-template.md

### Fields (invoice, United States example)

| Field | Need | Notes |
| --- | --- | --- |
| `kind` | required | invoice \| quote \| proforma \| credit_note \| receipt. Defaults to the page's document type. |
| `country_code` | required | The seller's country (ISO 3166-1 alpha-2). Decides currency, number and date format and tax rules. Supported: US, GB, DE, FR, NL, IE, AE, SG, AU, CA, IN, ES, IT, BE, AT, PT, FI, MX, BR. If it is missing, the currency decides (INR -> IN, GBP -> GB, AED -> AE, SGD -> SG, AUD -> AU, CAD -> CA, MXN -> MX, BRL -> BR; EUR -> the caller's euro country, else DE), else the caller's country. Always send it. |
| `currency` | optional | ISO 4217. Defaults to the country's (USD). Supported: USD, EUR, GBP, INR, AED, SGD, AUD, CAD, MXN, BRL. |
| `seller.name` | required | Your business or trading name. |
| `seller.address` | recommended | Postal address; new lines with \n. |
| `seller.email` | optional | Shown on the document. |
| `seller.tax_id` | optional | EIN (e.g. 12-3456789), if your client needs it. |
| `buyer.name` | required | The client or customer. |
| `buyer.address` | recommended | Billing address. |
| `buyer.email` | optional | Used later if the person sends it from LuckPanda. |
| `buyer.tax_id` | optional | Buyer tax ID if they ask for it. |
| `buyer.country_code` | optional | The buyer's country, if different from yours. |
| `issue_date` | optional | YYYY-MM-DD. Defaults to today. |
| `due_date` | optional | YYYY-MM-DD. Default 14 days after the issue date. |
| `lines` | required | 1 to 100 lines. |
| `lines[].description` | required | What was supplied (at most 500 characters). |
| `lines[].quantity` | required | Decimal as a string, up to 6 decimals ("1", "2.5"). |
| `lines[].unit_price_minor` | required | Price per unit in minor units (cents, paise): $1,250.50 is 125050. Or send lines[].unit_price in major units ("1250.50") instead. |
| `lines[].tax_rate_bp` | optional | Tax rate in basis points (18% = 1800). Or lines[].tax_percent (18). Default 0. |
| `lines[].unit_code` | optional | unit \| hour \| day \| month \| item. Default unit. |
| `lines[].discount_minor` | optional | Discount on the line, minor units (or lines[].discount in major units). |
| `notes` | optional | Shown on the document (at most 2000 characters). |
| `terms` | optional | Payment terms and bank details (at most 2000 characters). |

Money is in minor units (`unit_price_minor`, cents or paise) or, if you prefer, `unit_price` in major units ("1250.50"). Tax is `tax_rate_bp` (18% = 1800) or `tax_percent`. Dates are YYYY-MM-DD. Text is plain text: HTML is shown as typed, never rendered. Logos and document numbers are not accepted from links.

### Country rules

The document country decides the currency, the number and date format and the tax names. Tax ID by country:

| Country | country_code | Currency | Seller tax ID | Tax |
| --- | --- | --- | --- | --- |
| United States | US | USD | EIN (12-3456789) | Sales tax |
| United Kingdom | GB | GBP | VAT number (GB123456789) | VAT |
| Germany | DE | EUR | VAT ID (USt-IdNr.) (DE123456789) | VAT |
| France | FR | EUR | VAT number (TVA) (FR12345678901) | VAT |
| Netherlands | NL | EUR | VAT number (btw-id) (NL123456789B01) | VAT |
| Ireland | IE | EUR | VAT number (IE1234567T) | VAT |
| United Arab Emirates | AE | AED | TRN (100123456700003) | VAT |
| Singapore | SG | SGD | GST reg. no. (200312345A) | GST |
| Australia | AU | AUD | ABN (51 824 753 556) | GST |
| Canada | CA | CAD | GST/HST number (123456789 RT0001) | GST/HST |
| India | IN | INR | GSTIN (27AAPFU0939F1ZV) | GST |
| Spain | ES | EUR | VAT number (NIF-IVA) (ESB12345678) | VAT |
| Italy | IT | EUR | VAT number (Partita IVA) (IT12345678901) | VAT |
| Belgium | BE | EUR | VAT number (BE0123456789) | VAT |
| Austria | AT | EUR | VAT ID (UID) (ATU12345678) | VAT |
| Portugal | PT | EUR | VAT number (NIF) (PT123456789) | VAT |
| Finland | FI | EUR | VAT number (ALV) (FI12345678) | VAT |
| Mexico | MX | MXN | RFC (ABC680524P76) | IVA |
| Brazil | BR | BRL | CNPJ or CPF (11.222.333/0001-81) | Tax |

**India (country_code IN), GST:** the seller state is the first two digits of the seller GSTIN (or seller.state_code). Seller state = place of supply: CGST + SGST, each half the rate. Another state: IGST. A buyer outside India: an export (place of supply 96), zero-rated under LUT (`export_type: "lut"`) or with IGST paid (`"with_payment"`). If the seller state is unknown, GST is shown unsplit until it is given. Add HSN (goods) or SAC (services) codes per line.

**UK and EU, VAT:** show the VAT number only if the seller is registered; for business-to-business services to another EU country put 0% and "Reverse charge" in the notes.

Full rules for any type and country: `GET https://luckpanda.app/api/public/rules?document_type=invoice&country=US` or the MCP tool `get_document_rules`.

### Example document (JSON)

```json
{
  "kind": "invoice",
  "currency": "USD",
  "country_code": "US",
  "seller": {
    "name": "Juniper Lane Photography",
    "email": "hello@juniperlane.example",
    "address": "12 Mill Yard\nAsheville",
    "country_code": "US"
  },
  "buyer": {
    "name": "Copper Kettle Coffee Roasters",
    "email": "accounts@acme.example",
    "address": "7 Foundry Lane",
    "country_code": "US"
  },
  "issue_date": "2026-10-09",
  "due_date": "2026-10-23",
  "lines": [
    {
      "description": "Half-day commercial shoot at the roastery, 9 October (4 hours)",
      "quantity": "1",
      "unit_code": "unit",
      "unit_price_minor": 85000,
      "tax_rate_bp": 0
    },
    {
      "description": "Retouching and colour grading, per selected image",
      "quantity": "40",
      "unit_code": "item",
      "unit_price_minor": 1200,
      "tax_rate_bp": 0
    },
    {
      "description": "Usage licence: website, social media and printed menus, 2 years",
      "quantity": "1",
      "unit_code": "unit",
      "unit_price_minor": 40000,
      "tax_rate_bp": 0
    }
  ],
  "terms": "Payment due within 14 days. High-resolution files are delivered once this invoice is paid in full; the usage licence runs from the payment date."
}
```

### 1. Prefill link (no API call)

Put the JSON in `?doc=`, as base64url (UTF-8) or as URL-encoded raw JSON. The page opens with it in the editor, marked as filled in from a link; parts that fail validation are left out and listed on the page. Example:

https://luckpanda.app/templates/photography-invoice-template?doc=eyJraW5kIjoiaW52b2ljZSIsImN1cnJlbmN5IjoiVVNEIiwiY291bnRyeV9jb2RlIjoiVVMiLCJzZWxsZXIiOnsibmFtZSI6Ikp1bmlwZXIgTGFuZSBQaG90b2dyYXBoeSIsImVtYWlsIjoiaGVsbG9AanVuaXBlcmxhbmUuZXhhbXBsZSIsImFkZHJlc3MiOiIxMiBNaWxsIFlhcmRcbkFzaGV2aWxsZSIsImNvdW50cnlfY29kZSI6IlVTIn0sImJ1eWVyIjp7Im5hbWUiOiJDb3BwZXIgS2V0dGxlIENvZmZlZSBSb2FzdGVycyIsImVtYWlsIjoiYWNjb3VudHNAYWNtZS5leGFtcGxlIiwiYWRkcmVzcyI6IjcgRm91bmRyeSBMYW5lIiwiY291bnRyeV9jb2RlIjoiVVMifSwiaXNzdWVfZGF0ZSI6IjIwMjYtMTAtMDkiLCJkdWVfZGF0ZSI6IjIwMjYtMTAtMjMiLCJsaW5lcyI6W3siZGVzY3JpcHRpb24iOiJIYWxmLWRheSBjb21tZXJjaWFsIHNob290IGF0IHRoZSByb2FzdGVyeSwgOSBPY3RvYmVyICg0IGhvdXJzKSIsInF1YW50aXR5IjoiMSIsInVuaXRfY29kZSI6InVuaXQiLCJ1bml0X3ByaWNlX21pbm9yIjo4NTAwMCwidGF4X3JhdGVfYnAiOjB9LHsiZGVzY3JpcHRpb24iOiJSZXRvdWNoaW5nIGFuZCBjb2xvdXIgZ3JhZGluZywgcGVyIHNlbGVjdGVkIGltYWdlIiwicXVhbnRpdHkiOiI0MCIsInVuaXRfY29kZSI6Iml0ZW0iLCJ1bml0X3ByaWNlX21pbm9yIjoxMjAwLCJ0YXhfcmF0ZV9icCI6MH0seyJkZXNjcmlwdGlvbiI6IlVzYWdlIGxpY2VuY2U6IHdlYnNpdGUsIHNvY2lhbCBtZWRpYSBhbmQgcHJpbnRlZCBtZW51cywgMiB5ZWFycyIsInF1YW50aXR5IjoiMSIsInVuaXRfY29kZSI6InVuaXQiLCJ1bml0X3ByaWNlX21pbm9yIjo0MDAwMCwidGF4X3JhdGVfYnAiOjB9XSwidGVybXMiOiJQYXltZW50IGR1ZSB3aXRoaW4gMTQgZGF5cy4gSGlnaC1yZXNvbHV0aW9uIGZpbGVzIGFyZSBkZWxpdmVyZWQgb25jZSB0aGlzIGludm9pY2UgaXMgcGFpZCBpbiBmdWxsOyB0aGUgdXNhZ2UgbGljZW5jZSBydW5zIGZyb20gdGhlIHBheW1lbnQgZGF0ZS4ifQ

Or use simple parameters for the common fields:

| Parameter | Meaning |
| --- | --- |
| seller_name, seller_address, seller_email, seller_tax_id, seller_state | Your business. seller_state: Indian GST state code or name. |
| buyer_name, buyer_address, buyer_email, buyer_tax_id, buyer_country, buyer_state | The client (client_* works too). |
| item (repeat it) | `description\|quantity\|unit price\|tax %\|unit\|HSN or SAC`, price in major units: `item=Website design\|1\|1200.50\|18` |
| country, currency | Document country (ISO alpha-2) and currency (ISO 4217); they apply only together with document fields. |
| kind | invoice, quote, proforma, credit_note or receipt (default: the page's). |
| issue_date, due_date | YYYY-MM-DD. |
| notes, terms | Plain text. |
| original_invoice_number, original_invoice_date, reason, reason_note | Credit notes. |
| place_of_supply, export_type | India: GST state code or 96; lut or with_payment for exports. |

https://luckpanda.app/templates/photography-invoice-template?seller_name=Juniper%20Lane%20Photography&buyer_name=Copper%20Kettle%20Coffee%20Roasters&item=Half-day%20commercial%20shoot%20at%20the%20roastery%2C%209%20October%20%284%20hours%29%7C1%7C850.00%7C0%7Cunit

**Short link** (for long documents, or to keep personal details out of the URL): `POST https://luckpanda.app/api/public/drafts` with `{"page": "photography-invoice-template", "doc": {...}}` returns `{"url": "https://luckpanda.app/d/<id>", "totals": {...}, "missing": [...], "ignored": [...]}`. Links open for 7 days; at most 60 per hour per network.

```bash
curl -s -X POST https://luckpanda.app/api/public/drafts -H 'content-type: application/json' \
  -d '{"page":"photography-invoice-template","doc":{"kind":"invoice","currency":"USD","country_code":"US","seller":{"name":"Juniper Lane Photography","email":"hello@juniperlane.example","address":"12 Mill Yard\nAsheville","country_code":"US"},"buyer":{"name":"Copper Kettle Coffee Roasters","email":"accounts@acme.example","address":"7 Foundry Lane","country_code":"US"},"issue_date":"2026-10-09","due_date":"2026-10-23","lines":[{"description":"Half-day commercial shoot at the roastery, 9 October (4 hours)","quantity":"1","unit_code":"unit","unit_price_minor":85000,"tax_rate_bp":0},{"description":"Retouching and colour grading, per selected image","quantity":"40","unit_code":"item","unit_price_minor":1200,"tax_rate_bp":0},{"description":"Usage licence: website, social media and printed menus, 2 years","quantity":"1","unit_code":"unit","unit_price_minor":40000,"tax_rate_bp":0}],"terms":"Payment due within 14 days. High-resolution files are delivered once this invoice is paid in full; the usage licence runs from the payment date."}}'
```

### 2. Branded PDF (no sign-in)

`POST https://luckpanda.app/api/public/pdf` with `{"doc": {...}}` (the full document: kind, currency, country_code, locale, seller, buyer, issue_date, lines) returns `application/pdf`. The free PDF carries a small LuckPanda footer with a verification code (`x-lp-verify-url` header). Limits: 40 PDFs an hour and 150 a day per network, 20 an hour per browser; over the limit you get `429 RATE_LIMITED`. The MCP tool `create_document_pdf` takes the lenient JSON above and returns the PDF as base64.

```bash
curl -s -X POST https://luckpanda.app/api/public/pdf -H 'content-type: application/json' \
  -d '{"doc":{"kind":"invoice","currency":"USD","country_code":"US","locale":"en-US","seller":{"name":"Juniper Lane Photography","email":"hello@juniperlane.example","address":"12 Mill Yard\nAsheville","country_code":"US"},"buyer":{"name":"Copper Kettle Coffee Roasters","email":"accounts@acme.example","address":"7 Foundry Lane","country_code":"US"},"number":null,"issue_date":"2026-10-09","due_date":"2026-10-23","lines":[{"description":"Half-day commercial shoot at the roastery, 9 October (4 hours)","quantity":"1","unit_code":"unit","unit_price_minor":85000,"tax_rate_bp":0},{"description":"Retouching and colour grading, per selected image","quantity":"40","unit_code":"item","unit_price_minor":1200,"tax_rate_bp":0},{"description":"Usage licence: website, social media and printed menus, 2 years","quantity":"1","unit_code":"unit","unit_price_minor":40000,"tax_rate_bp":0}],"notes":"","terms":"Payment due within 14 days. High-resolution files are delivered once this invoice is paid in full; the usage licence runs from the payment date."}}' -o photography-invoice-template.pdf
```

### 3. MCP server (no auth)

Streamable HTTP at `https://luckpanda.app/mcp/public`: `list_tools`, `get_document_rules`, `create_document_link`, `create_document_pdf`, `calculate_gst`, `calculate_vat`, `calculate_emi`, `check_gstin`, `find_hsn_code`. Install: https://luckpanda.app/agents.

### What needs a LuckPanda account

Agents propose; people decide. Nothing made here is issued, sent or paid by an agent. The person signs in free to keep going:

- **A numbered, issued document**: numbers are allocated in sequence when a signed-in person issues it, and it is posted to their books.
- **Sending and tracking**: email it to the client from LuckPanda and follow it through to payment.
- **Payment links** and automatic reminders.
- **Verifications** (GSTIN and other registry checks) and e-invoicing.
- **The clean PDF** without LuckPanda branding (the Sales module).
- **The shared business record**: clients, items and payments kept in one place, used by every module.

Sign in: https://luckpanda.app/signin. Pricing: https://luckpanda.app/pricing.md. All agent options: https://luckpanda.app/agents.md.