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.