QRMint API Documentation

<img src="https://qrmint.dev/api/v1/generate?data=https://example.com" alt="QR Code" />

<!-- With custom styling -->
<img src="https://qrmint.dev/api/v1/generate?data=https://example.com&foreground=ff00aa&background=0a0a0f&size=512&frameId=scan-me" alt="Styled QR Code" />

curl -X POST "https://qrmint.dev/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://example.com",
    "foreground": "#ff00aa",
    "background": "#0a0a0f",
    "size": 512,
    "style": "dots",
    "errorCorrectionLevel": "H",
    "frameId": "scan-me"
  }' \
  --output qrcode.png

curl "https://qrmint.dev/api/v1/generate?data=https://example.com&output=base64"

# POST with base64 output:
curl -X POST "https://qrmint.dev/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{"data": "https://example.com", "style": "dots", "output": "base64"}'

{
  "status": "success",
  "data": {
    "image": "data:image/png;base64,iVBORw0KGgoAAAANSUh...",
    "format": "png",
    "mimeType": "image/png",
    "dataLength": 12345
  }
}

const res = await fetch('https://qrmint.dev/api/v1/generate?data=https://example.com&output=base64');
const { data } = await res.json();
document.getElementById('qr').src = data.image;  // Ready to use!

import requests, base64
resp = requests.get('https://qrmint.dev/api/v1/generate', params={'data': 'https://example.com', 'output': 'base64'})
image_data = resp.json()['data']['image']  # data:image/png;base64,...
# Save to file:
b64 = image_data.split(',')[1]
with open('qr.png', 'wb') as f:
    f.write(base64.b64decode(b64))

curl -X POST "https://qrmint.dev/api/v1/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {
        "data": "https://example.com/product1",
        "filename": "product1.png",
        "frameId": "scan-me"
      },
      {
        "data": "https://example.com/product2",
        "filename": "product2.png",
        "foreground": "#ff0000"
      }
    ]
  }' \
  --output qrcodes.zip

curl "https://qrmint.dev/api/v1/frames"

{
  "status": "success",
  "data": {
    "frames": [
      {
        "id": "scan-me",
        "name": "Scan Me",
        "description": "Classic 'Scan Me' call-to-action frame"
      },
      ...
    ],
    "count": 6
  }
}

<img src="https://qrmint.dev/api/v1/generate/typed?type=wifi&ssid=CafeWiFi&password=latte123&frameId=wifi" alt="WiFi QR code">

curl "https://qrmint.dev/api/v1/generate/typed?type=vcard&firstName=John&lastName=Doe&phone=%2B1234567890&email=john@example.com&style=rounded" -o contact.png

curl "https://qrmint.dev/api/v1/generate/typed?type=event&title=Team+Meeting&start=2026-04-01T10:00:00Z&location=Office&gradientType=linear&gradientColors=ff00aa,00f0ff" -o event.png

https://qrmint.dev/api/v1/generate/typed?type=epc&name=Max+Mustermann&iban=DE89370400440532013000&amount=42.50&text=Invoice+%231234

https://qrmint.dev/api/v1/generate/typed?type=geo&latitude=52.5200&longitude=13.4050&label=Berlin

curl -X POST "https://qrmint.dev/api/v1/generate/typed" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "wifi",
    "ssid": "CafeNetwork",
    "password": "welcome2024",
    "encryption": "WPA",
    "frameId": "wifi"
  }' \
  --output wifi-qr.png

curl -X POST "https://qrmint.dev/api/v1/generate/typed" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "vcard",
    "firstName": "Jane",
    "lastName": "Smith",
    "phone": "+1234567890",
    "email": "jane@example.com",
    "organization": "Acme Inc",
    "title": "CTO",
    "size": 1024,
    "errorCorrectionLevel": "H"
  }' \
  --output contact.png

curl -X POST "https://qrmint.dev/api/v1/generate/typed" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "event",
    "title": "Product Launch",
    "start": "2026-04-01T14:00:00Z",
    "end": "2026-04-01T16:00:00Z",
    "location": "Main Auditorium",
    "description": "Annual product launch event"
  }' \
  --output event-qr.png

curl -X POST "https://qrmint.dev/api/v1/generate/typed" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "epc",
    "name": "Max Mustermann",
    "iban": "DE89370400440532013000",
    "amount": 42.50,
    "text": "Invoice #1234"
  }' \
  --output epc-payment.png

curl -X POST "https://qrmint.dev/api/v1/generate/typed" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "geo",
    "latitude": 52.5200,
    "longitude": 13.4050,
    "label": "Brandenburg Gate, Berlin"
  }' \
  --output location.png

{
  "error": "Validation error",
  "message": "\"data\" field is required"
}

curl -X POST "https://qrmint.dev/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{"data": "https://example.com"}' \
  --output qrcode.png

curl -X POST "https://qrmint.dev/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://example.com",
    "foreground": "#ff00aa",
    "background": "#0a0a0f",
    "size": 1024,
    "errorCorrectionLevel": "H",
    "frameId": "scan-me"
  }' \
  --output qrcode.png

curl -X POST "https://qrmint.dev/api/v1/generate" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://example.com",
    "style": "dots",
    "gradient": {
      "type": "linear",
      "colors": ["#ff00aa", "#00f0ff"],
      "angle": 45
    }
  }' \
  --output gradient-qr.png

# Or via GET:
# https://qrmint.dev/api/v1/generate?data=https://example.com&gradientType=linear&gradientColors=ff00aa,00f0ff&gradientAngle=45

// Generate QR code and display in <img> tag
const response = await fetch('https://qrmint.dev/api/v1/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    data: 'https://example.com',
    foreground: '#ff00aa',
    background: '#0a0a0f',
    size: 512,
    frameId: 'scan-me'
  })
});

const blob = await response.blob();
const url = URL.createObjectURL(blob);
document.getElementById('qr-image').src = url;

const fs = require('fs');
const fetch = require('node-fetch');

const response = await fetch('https://qrmint.dev/api/v1/generate', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    data: 'https://example.com',
    size: 1024,
    errorCorrectionLevel: 'H'
  })
});

const buffer = await response.buffer();
fs.writeFileSync('qrcode.png', buffer);

import requests

response = requests.post(
    'https://qrmint.dev/api/v1/generate',
    json={
        'data': 'https://example.com',
        'foreground': '#ff00aa',
        'background': '#0a0a0f',
        'size': 512,
        'errorCorrectionLevel': 'H',
        'frameId': 'scan-me'
    }
)

with open('qrcode.png', 'wb') as f:
    f.write(response.content)

import requests

# Generate multiple QR codes
response = requests.post(
    'https://qrmint.dev/api/v1/batch',
    json={
        'items': [
            {
                'data': 'https://example.com/product1',
                'filename': 'product1.png',
                'frameId': 'scan-me'
            },
            {
                'data': 'https://example.com/product2',
                'filename': 'product2.png',
                'foreground': '#00ff00'
            }
        ]
    }
)

# Save ZIP archive
with open('qrcodes.zip', 'wb') as f:
    f.write(response.content)

{
  "mcpServers": {
    "qrmint": {
      "command": "npx",
      "args": ["-y", "qrmint-mcp"]
    }
  }
}