Skip to main content

​
QR Codes

Create QR codes for your links with scan tracking and attribution.

​
Creating QR Codes

​
From the Dashboard

  1. Open any link
  2. Click the QR Code button
  3. Customize settings
  4. Download or share

​
Via API

curl -X POST https://api.linquid.io/qr \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "linkId": "link_abc123",
    "name": "Billboard NYC",
    "size": 512,
    "format": "png",
    "errorCorrection": "H"
  }'

​
QR Code Options

OptionValuesDefaultDescription
size128-2048256Size in pixels
formatpng, svgpngOutput format
errorCorrectionL, M, Q, HMError correction level

​
Error Correction Levels

LevelRecoveryUse Case
L7%Clean environments
M15%Standard use
Q25%Expected damage
H30%Maximum reliability
Use H (high) error correction for QR codes that will be printed on physical materials.

​
Named QR Codes

Create multiple named QR codes per link for placement attribution: 
{
  "linkId": "link_abc123",
  "qrCodes": [
    { "name": "Billboard NYC", "code": "nyc" },
    { "name": "Store Display SF", "code": "sf" },
    { "name": "Flyer Campaign", "code": "flyer" }
  ]
}
Each generates a unique trackable URL:
  • https://linqu.id/abc123?qr=nyc
  • https://linqu.id/abc123?qr=sf
  • https://linqu.id/abc123?qr=flyer

​
Scan Tracking

Each QR code tracks:
  • Total scans - All scan events
  • Unique scans - Deduplicated by device
  • Last scanned - Most recent scan time
  • Location - Geographic data (if available)

​
Analytics

View QR performance in the dashboard:
  • Scans over time
  • Geographic distribution
  • Device breakdown
  • Compare QR placements

​
Scan Deduplication

Scans are deduplicated using:
  1. Device fingerprint
  2. QR code identifier
  3. Time window (configurable)
This prevents the same person scanning multiple times from inflating counts.

​
Physical Placement Tips

  • Minimum 2cm x 2cm for scanning
  • 5cm+ for outdoor/distance scanning
  • Test scan distance before printing
  • Dark QR on light background
  • Avoid low-contrast colors
  • Matte finish prevents glare
  • Eye level when possible
  • Avoid curved surfaces
  • Protect from weather outdoors

​
Downloading

​
PNG (Raster)

Best for:
  • Digital displays
  • Social media
  • Email

​
SVG (Vector)

Best for:
  • Print materials
  • Large format
  • Professional printing

​
API Response

{
  "success": true,
  "data": {
    "id": "qr_abc123",
    "linkId": "link_xyz789",
    "name": "Billboard NYC",
    "code": "nyc",
    "imageUrl": "https://assets.linquid.io/qr/qr_abc123.png",
    "scanUrl": "https://linqu.id/xyz789?qr=nyc",
    "totalScans": 0,
    "uniqueScans": 0
  }
}