API reference/14 of 22

Generate QR

Create a static PNG, SVG, or PDF.

POST/api/v1/generate

Create a static QR image. Guests can call this without auth (IP rate limits apply). API keys need the generate scope (Business plan to create keys).

Pass ?response=json for JSON with format, mime, meta, auth, data_base64 — or omit for binary image bytes.

Auth: Optional — guest, user JWT, or Business API key · Scope: generate

JSON body

  • contentobjectRequired

    { type, data } — see Content types

  • formatstring

    png | svg | pdf (default png)

  • presetstring

    Optional size/style preset (e.g. business_card)

  • styleobject

    Colors, modules, eye styles, quiet zone

  • responsestring

    binary (default) or json — also as query ?response=

curl -s -X POST "https://api.getmaxqr.com/api/v1/generate?response=json" \
  -H "content-type: application/json" \
  -d '{"content":{"type":"url","data":{"url":"https://example.com"}},"format":"png"}'
Response
{
  "format": "png",
  "mime": "image/png",
  "meta": { "content_type": "url", "reliability": { "score": 1 } },
  "auth": "guest",
  "data_base64": "iVBORw0KGgo…"
}