# Print a QR code poster, table tent, card or sticker sheet

Make a print-ready PDF or PNG of a QR code poster, table tent, WiFi card, business card sheet or sticker sheet.

- Endpoint: `POST https://setget.net/v1/tools/qr-print` with JSON `{"input": {...}}` (add `"wait": 30` to hold the reply until the job finishes)
- MCP: `run_tool` with `slug` = `qr-print`
- Page: https://setget.net/tools/qr-print

## Files in, files out

This is a file tool. Its file inputs take file references, not file contents and not web addresses.

- Get a reference by uploading: `curl -T FILE https://setget.net/drop/` prints a line `ref  <id>/f1`. Or `POST https://setget.net/v1/drops` with `{"files":[{"name","size"}]}`, PUT the bytes to the returned `upload.url` with the listed headers, and use the file's `ref`. Over MCP use the `drop` tool. A file under about 700 KB can also be sent in place as a `data:<type>;base64,<content>` URI.
- Uploads are at most 100 MB per file, are readable by anyone with the link, and expire (one hour by default). Programs are refused.
- The tool runs as a job. The reply is `{"tool", "ms", "result", "files", "job"}`: `result` is JSON, and every result file comes back in `files` as `{"name", "size", "content_type", "kind", "url", "ref"}`. Download it from `url`, or pass `ref` as the input of another file tool.
- A job still running when the wait ends answers 202 with `job`. Follow it with `GET https://setget.net/v1/jobs/<id>?wait=30`, or stream progress from `GET https://setget.net/v1/jobs/<id>/events` (over MCP: the `job` tool). A person can watch it at `job.url`.

## Inputs

- `text` (required, string): The text or link to store in the code. For the WiFi card, the "text" of the WiFi QR tool's result.
- `template` (optional, string, one of `poster`, `table-tent`, `wifi-card`, `business-cards`, `stickers`, `mockup-poster`, `mockup-phone`, `mockup-tent`, `mockup-card`, `mockup-sticker`, default `"poster"`): The page to make. Print templates come out at their real size: poster, table-tent (fold the page in half), wifi-card, business-cards (ten to a sheet) and stickers (twelve to a sheet). The mockup templates are pictures of the code in use.
- `title` (optional, string): The headline, or the name on a business card. Left out, the template uses its own words ("Scan me", "Wi-Fi"); give an empty text for none.
- `subtitle` (optional, string): The line by the code, or the job title on a business card. Left out, the template uses its own words.
- `details` (optional, string): More lines, one per line: opening hours, an address, a phone number. On the WiFi card write "Label: value" lines, or leave this out and the network name and password are read from the code itself.
- `page` (optional, string, one of `a4`, `letter`, default `"a4"`): Paper size of the print templates.
- `accent` (optional, string, default `"#1d4ed8"`): The color of the template's bands and highlights.
- `paper` (optional, string, default `"#ffffff"`): The color of the page or card.
- `format` (optional, string, one of `pdf`, `png`, default `"pdf"`): File to make: pdf at the real size for printing, or a png picture.
- `dpi` (optional, integer, default `300`, range 72..600): Dots per inch of a png of a print template.
- `verify` (optional, boolean, default `true`): Read every code on a print template back with a decoder before returning the file.
- `error_correction` (optional, string, one of `L`, `M`, `Q`, `H`): How much damage the code survives: L about 7%, M 15%, Q 25%, H 30%. Higher levels hold less. Left out: M, or H when there is a logo.
- `module_size` (optional, integer, default `8`, range 1..40): Width of one small square (module) in pixels.
- `margin` (optional, integer, default `4`, range 0..20): Blank quiet zone around the code, in modules. Scanners expect at least 4.
- `foreground` (optional, string): Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black.
- `background` (optional, string): Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white.
- `preset` (optional, string, one of `classic`, `rounded`, `liquid`, `dots`, `ocean`, `sunset`, `forest`, `grape`, `candy`, `ink`, `gold`, `midnight`): A ready-made look. Any style input you set yourself wins over the preset.
- `dot_style` (optional, string, one of `square`, `rounded`, `liquid`, `dots`, `diamond`, `star`, `vertical`, `horizontal`, `leaf`, `mosaic`, `plus`, `hexagon`, `heart`, `maze`): Shape of the small squares (modules). Left out: square.
- `dot_scale` (optional, number, range 0.5..1): Size of each dot within its square, from 0.5 to 1. Thin shapes need more, such as diamond 0.7 and star 0.95 (the error names the least); liquid always fills its square.
- `eye_frame_style` (optional, string, one of `square`, `rounded`, `extra-rounded`, `circle`, `leaf`, `dotted`): Shape of the outer ring of the three corner eyes.
- `eye_ball_style` (optional, string, one of `square`, `rounded`, `circle`, `diamond`, `leaf`, `octagon`): Shape of the solid middle of the three corner eyes.
- `eye_colour` (optional, string): Color of the eye rings. Left out: the dot color.
- `eye_ball_colour` (optional, string): Color of the middle of the eyes. Left out: the eye ring color.
- `eye_colours` (optional, string): A color for each eye, separated by commas, in the order top-left, top-right, bottom-left: for instance "#b91c1c, #1d4ed8, #15803d". Plain colors only. An eye left out, or left empty between commas, keeps eye_colour.
- `corner_radius` (optional, number, range 0..0.5): Rounds the corners of the background, as a fraction of its side.
- `shape` (optional, string, one of `square`, `circle`, `squircle`, `octagon`, `hexagon`, `shield`, `bubble`, `heart`): Outline of the whole code: square, or a silhouette such as circle or heart. The code itself stays a complete square inside it, behind a clear ring as wide as margin, and matching dots fill the rest of the outline. Left out: square.
- `logo` (optional, file, a file reference such as `DROP_ID/f1`, accepts image): A picture for the middle of the code: PNG, JPEG, WebP, GIF or SVG. Large pictures are shrunk.
- `logo_size` (optional, number, range 0.1..0.4): Largest logo width as a fraction of the code, from 0.1 to 0.4. It is made smaller when the code would not scan. Left out: 0.22.
- `logo_padding` (optional, number, range 0..3): Clear space around the logo, in modules. Left out: 1.
- `logo_shape` (optional, string, one of `none`, `square`, `rounded`, `circle`): Shape of the clear area behind the logo. "none" leaves the background showing.
- `logo_background` (optional, string): Color of the clear area behind the logo. Left out: the background color.
- `logo_text` (optional, string): One to four characters for the middle of the code in place of a picture, such as initials. Drawn as outlines in the frame font, so they look the same everywhere.
- `logo_icon` (optional, string, one of `heart`, `star`, `wifi`, `phone`, `mail`, `link`, `home`, `pin`, `cart`, `bag`, `camera`, `music`, `calendar`, `person`, `globe`, `lock`, `gift`, `cup`, `bolt`, `chat`, `play`, `info`, `tag`, `book`): A small symbol for the middle of the code in place of a picture.
- `logo_colour` (optional, string): Color of the center text or symbol. Left out: the eye color.
- `background_image` (optional, file, a file reference such as `DROP_ID/f1`, accepts image): A photo to show behind the code. Large photos are shrunk.
- `background_image_wash` (optional, number, range 0..0.9): How much the photo is lightened, from 0 to 0.9. Left out: 0.35.
- `frame` (optional, string, one of `none`, `label`, `banner`, `banner-top`, `rounded`): A border with a short call to action under (or above) the code.
- `frame_text` (optional, string): The words in the frame. Left out: SCAN ME.
- `frame_colour` (optional, string): Color of the frame. Left out: the dot color.
- `frame_text_colour` (optional, string): Color of the frame text. Left out: whichever of dark or light reads best.
- `frame_font` (optional, string, one of `sans`, `mono`): Letter style of the frame text.

## Example 1: A table tent as a PDF: print, fold in half, stand it up

```json
{"input":{"text":"https://setget.net","template":"table-tent","title":"Menu","preset":"ocean","accent":"#0c4a6e"},"wait":30}
```

## Example 2: A WiFi card as a picture

```json
{"input":{"text":"WIFI:T:WPA;S:Cafe Luna Guests;P:espresso2026;;","template":"wifi-card","format":"png"},"wait":30}
```

## Example 3: Twelve round stickers on a Letter sheet

```json
{"input":{"text":"https://setget.net","template":"stickers","title":"Scan me","shape":"circle","margin":2,"page":"letter"},"wait":30}
```

**How do I get the size right?** Print the PDF at 100 percent ("actual size"), not "fit to page". The result gives the printed width of the code and of one module in millimeters.

**What does verified mean here?** The page was drawn at 150 dots per inch, a modest printer, and every code on it was read back by a decoder and gave exactly your text.

**How do I use the table tent?** Print the page, fold it in half along the marks, and stand it up like a roof: both faces read the right way up.

**Can I see it first?** Yes. The QR template tool shows the same page instantly, with the same inputs.
