Skip to main content

1. Get your API key

Sign in to QRKit and open Dashboard → API Keys. Create a new key with qr:read and qr:write scopes (API access is included on all paid plans).
Your full API key is only shown once at creation. Copy it and store it securely.

2. Create a QR code

Make your first API call to create a dynamic QR code:
curl -X POST https://api.useqrkit.com/v1/qr-codes \
  -H "Authorization: Bearer qr_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Website",
    "type": "dynamic",
    "target": {
      "type": "url",
      "destination": "https://example.com"
    }
  }'

3. View the response

A successful request returns the created QR code object:
{
  "id": "qr_123",
  "object": "qr_code",
  "kind": "dynamic",
  "name": "My Website",
  "type": "url",
  "short_code": "AB3D5",
  "short_url": "https://scan.useqrkit.com/AB3D5",
  "target": {
    "type": "url",
    "destination": "https://example.com"
  },
  "design": {
    "colors": { "foreground": "#000000", "background": "#ffffff" },
    "gradient": null,
    "shapes": { "body": "square", "eye_frame": "square", "eye_ball": "square" },
    "eye_colors": null,
    "has_logo": false,
    "transparent_background": false
  },
  "folder_id": null,
  "tags": [],
  "image_url": "https://img.useqrkit.com/qr-AB3D5-1717000000000.svg",
  "download_url": "/v1/qr-codes/qr_123/download",
  "is_active": true,
  "scan_count": 0,
  "utm": null,
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-01-15T10:30:00Z"
}
The QR image itself encodes short_url — print it once and change the destination any time with Update QR Code. WiFi, email, SMS, text and event codes are static instead: the payload is encoded directly into the image (no short_url, no scan tracking) and their ids start with sqr_.

4. Download the image

Download the QR code image in SVG or PNG format:
curl https://api.useqrkit.com/v1/qr-codes/qr_123/download?format=png&size=500 \
  -H "Authorization: Bearer qr_live_your_key_here" \
  --output qrcode.png

Next steps

Authentication

Learn about API key scopes and environments.

Custom Designs

Customize colors, shapes, and logos.

Error Handling

Handle errors gracefully in your integration.

Rate Limits

Understand rate limits for your plan.