A QR code API that does more than draw squares

PikaQR is the layer between a printed code and your software. Create codes, decide what each scan does, and hear about it the moment it happens.

Create a code

One request, and you have a short link to print.

curl https://pikaqr.com/api/v1/qr \
  -H "Authorization: Bearer $PIKAQR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Dinner menu",
    "qr_type": "menu",
    "destination_url": "https://example.com/menu",
    "tags": ["dining-room"],
    "metadata": { "site": "main" }
  }'

Hear about every scan

Each scan arrives as a signed event with what you need to act on it.

{
  "id": "evt_6f1c2e",
  "type": "scan.created",
  "created_at": "2026-11-07T19:42:10.000Z",
  "data": {
    "code": {
      "id": "b3a1…",
      "short_code": "abc123",
      "title": "Dinner menu",
      "type": "menu",
      "tags": ["dining-room"],
      "metadata": { "site": "main" }
    },
    "scan": {
      "device": "mobile",
      "os": "iOS",
      "language": "es",
      "country": "ES",
      "table": { "id": "7d2e…", "name": "Table 12" },
      "destination": "https://example.com/menu",
      "rule": { "type": "time", "label": "Dinner" },
      "unique": true
    }
  }
}
import { createHmac, timingSafeEqual } from 'node:crypto';

// `body` must be the raw request body, before any JSON parsing.
function isFromPikaQR(body, header, secret) {
  const { t, v1 } = Object.fromEntries(header.split(',').map((part) => part.split('=')));
  const expected = createHmac('sha256', secret).update(`${t}.${body}`).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  return fresh && timingSafeEqual(Buffer.from(v1), Buffer.from(expected));
}

Built to be pleasant to work with

A code for each thing

Create one code per table, room or order from your software, each with its own link and scans.

Your ids, returned

Attach metadata to a code and get it back on every scan event.

Signed events

Webhooks are signed, retried for hours, and logged so you can see what happened.

Rules as data

Read and write routing rules through the API, and keep them with your other configuration.

Predictable errors

A message for people, a stable code for programs, and rate limits in every reply.

An OpenAPI description

Generate a client, or point your tools at it.

QR code API for developers · PikaQR