QR Code Generator · Schema
Raw schema.

Same JSON the GET /v1/general-utility/qr-code-generator/schema endpoint returns — formatted for reading. Use it to codegen typed clients or document the contract.
← Back to tool docs Try it interactively Hit the live endpoint
qr-code-generator.schema.json
{
  "tool": "qr-code-generator",
  "domain": "general-utility",
  "version": "1.0.0",
  "name": "QR Code Generator",
  "description": "Generate a QR code from text, URL, or any payload. Pick foreground colour, background colour (or transparent), error correction level, margin and size. Returns SVG, base64 data URL, and ASCII preview.",
  "standard": null,
  "inputs": [
    {
      "key": "content",
      "label": "Content",
      "required": true,
      "placeholder": "URL, text, vCard, Wi-Fi config — anything",
      "help": "Anything you want to encode. URLs, plain text, Wi-Fi credentials, vCards, UPI strings.",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "default": "https://toolsamurai.com"
    },
    {
      "key": "error_correction",
      "label": "Error Correction",
      "help": "L ≈ 7% recovery · M ≈ 15% · Q ≈ 25% · H ≈ 30%. Higher = more robust but bigger QR. Use H for logos overlaid on the code.",
      "type": "enum",
      "options": [
        "L",
        "M",
        "Q",
        "H"
      ],
      "default": "M"
    },
    {
      "key": "foreground",
      "label": "Foreground Colour",
      "help": "Hex (#000000), rgb(), or any CSS named colour. The dark modules of the QR.",
      "type": "string",
      "maxLength": 32,
      "default": "#0c0c0d"
    },
    {
      "key": "background",
      "label": "Background Colour",
      "help": "Hex, CSS colour, or the literal word \"transparent\" for no fill.",
      "type": "string",
      "maxLength": 32,
      "default": "#ffffff"
    },
    {
      "key": "margin",
      "label": "Quiet Zone",
      "unit": "modules",
      "help": "Empty border in QR modules. Standard is 4. Set 0 for edge-to-edge.",
      "type": "integer",
      "min": 0,
      "max": 20,
      "step": 1,
      "default": 4
    },
    {
      "key": "size",
      "label": "Size",
      "unit": "px",
      "type": "integer",
      "min": 64,
      "max": 4096,
      "step": 32,
      "default": 512
    },
    {
      "key": "format",
      "label": "Output Format",
      "help": "svg = vector, infinite scaling, tiny file. png = lossless raster with transparency. jpeg = smaller, no transparency. webp = modern, smaller than png.",
      "type": "enum",
      "options": [
        "svg",
        "png",
        "jpeg",
        "webp"
      ],
      "default": "svg"
    }
  ],
  "outputs": [
    {
      "key": "image_data_url",
      "label": "QR Code",
      "type": "string",
      "render": "image"
    },
    {
      "key": "svg",
      "label": "SVG Source",
      "type": "string",
      "render": "code"
    },
    {
      "key": "ascii",
      "label": "ASCII Preview",
      "type": "string",
      "render": "ascii"
    },
    {
      "key": "module_count",
      "label": "Modules",
      "type": "integer",
      "unit": "×"
    },
    {
      "key": "qr_version",
      "label": "QR Version",
      "type": "integer"
    },
    {
      "key": "byte_length",
      "label": "Payload Size",
      "type": "integer",
      "unit": "bytes"
    }
  ],
  "endpoint": "/v1/general-utility/qr-code-generator"
}