Generate text QR code
generate_text_qr_codeRead-onlyIdempotent
Use this when the user wants a PNG and SVG QR image that displays plain text when scanned. Accepts up to 1,500 characters, preserves whitespace, and reports contrast, density and optional print width. Encoded UTF-8 content must fit 1,273–2,953 bytes depending on error correction. Static codes only; does not read QR images or make barcodes or Wi-Fi codes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | Plain text to encode, up to 1,500 characters; whitespace is preserved. Example: Table 12 - ask for the specials. | |
| background | No | Background colour as hex, e.g. #FFFFFF (default). | |
| foreground | No | Code (module) colour as hex, e.g. #111111 (default). Dark colours scan best. Basic colour names like navy or black also work. | |
| error_correction | No | Damage tolerance, e.g. M: L 7%, M 15% (default), Q 25%, H 30%. Use H for printed codes that may get scuffed or carry a logo sticker. | |
| scan_distance_cm | No | Optional distance in centimetres from which people will scan the printed code, e.g. 300 for a poster across a room; used to recommend a minimum print size. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| svg | Yes | ||
| kind | Yes | ||
| modules | Yes | ||
| payload | Yes | ||
| request | Yes | ||
| summary | Yes | ||
| version | Yes | ||
| warnings | Yes | ||
| downloads | Yes | ||
| background | Yes | ||
| foreground | Yes | ||
| contrast_ratio | Yes | ||
| error_correction | Yes | ||
| min_print_size_cm | Yes |