Q
QRLifetime
Codes never expire
Log in
EN DE FR ES

QRLifetime API

Create dynamic QR codes from your own systems, change where they point after printing, and read their scan counts. JSON over HTTPS, authenticated with a Bearer key.

Overview

  • Base URL: https://app.qrlifetime.com/api/v1
  • Format: JSON request and response bodies, UTF-8.
  • Authentication: Authorization: Bearer qrl_… on every request.
  • Plan: Business. Each key allows 10,000 calls per calendar month (UTC).
  • Codes created by the API are the same as in the dashboard: same quotas, same team access, same statistics.
  • The redirect never checks billing: if the plan ends, existing codes keep redirecting to their last destination.

Get an API key

  1. Sign in to app.qrlifetime.com with a Business account.
  2. Open API, give the key a name and create it.
  3. Copy the key right away. It is shown only once: we store a hash of it, not the key itself.

The page also shows, for each key, the date of its last use and its calls for the current month. Deleting a key stops every app that uses it immediately.

Endpoints

MethodPathWhat it does
GET/codes?page=1List your codes, newest first, 50 per page.
POST/codesCreate a dynamic QR code. Returns 201 and the code.
GET/codes/{slug}Read one code, with its total number of scans.
PATCH/codes/{slug}Change its name, destination or style.
DELETE/codes/{slug}Delete it. A printed code pointing to it stops working.

Paths are relative to the base URL. A slug has 4 to 16 letters and digits.

List your codes

curl -H "Authorization: Bearer $QRL_KEY" \
  "https://app.qrlifetime.com/api/v1/codes?page=1"

The response contains docs (the codes), page, totalPages, totalDocs and hasNextPage.

Create a code

curl -X POST -H "Authorization: Bearer $QRL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Spring flyer","destination":"https://example.com/spring"}' \
  "https://app.qrlifetime.com/api/v1/codes"

destination is required. name and design are optional: without a design, your brand kit is applied when you have one. The slug, the owner and the team cannot be set through the API.

HTTP/1.1 201 Created

{
  "slug": "ab3k7mx",
  "name": "Spring flyer",
  "destination": "https://example.com/spring",
  "shortUrl": "https://q.qrlifetime.com/ab3k7mx",
  "link": "https://qrkeep.me/ab3k7mx",
  "kind": "subscription",
  "design": null,
  "createdAt": "2026-11-22T10:00:00.000Z",
  "updatedAt": "2026-11-22T10:00:00.000Z",
  "scans": 0
}

Read one code

curl -H "Authorization: Bearer $QRL_KEY" \
  "https://app.qrlifetime.com/api/v1/codes/ab3k7mx"

Change the destination

curl -X PATCH -H "Authorization: Bearer $QRL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination":"https://example.com/summer"}' \
  "https://app.qrlifetime.com/api/v1/codes/ab3k7mx"

Send any of name, destination and design. Fields you leave out are not changed. Printed codes follow the new destination on the next scan, because the redirect uses a 302 status that browsers do not cache.

Delete a code

curl -X DELETE -H "Authorization: Bearer $QRL_KEY" \
  "https://app.qrlifetime.com/api/v1/codes/ab3k7mx"

Returns {"deleted":true,"slug":"ab3k7mx"}. Unlike a cancelled plan, a deletion stops the redirect: only delete codes that are not printed anywhere.

JavaScript example

const res = await fetch("https://app.qrlifetime.com/api/v1/codes", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.QRL_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Table 12", destination: "https://example.com/menu" }),
});
if (!res.ok) throw new Error((await res.json()).error);
const code = await res.json();
console.log(code.shortUrl); // encode this URL in your QR code

The code object

FieldTypeDescription
slugstringIdentifier generated by QRLifetime, used in the URLs below.
namestringYour label, up to 120 characters.
destinationstringWhere the code redirects (http or https URL).
shortUrlstringURL encoded in the QR code (q.qrlifetime.com, or your own domain on Business).
linkstringSame code as a short link to type or share (qrkeep.me, or your own domain).
kindstringHow the code was obtained: subscription or lifetime.
designobject | nullStyle used by the editor (colours, logo, frame). Null when none is set.
createdAt, updatedAtstringISO 8601 dates.
scansnumberTotal scans. Returned when you read one code, and 0 on creation.

Errors

Errors return a JSON body with a single error message, for example {"error":"QR code not found."}.

StatusMeaning
400Invalid input: a body that is not a JSON object, a missing or invalid destination, or a destination flagged as malware or phishing.
401Missing, malformed or unknown API key.
402The owner of the key has no active Business plan, or a plan limit is reached (number of codes).
404No code with this slug in your account or team.
429The key reached its 10,000 calls for the current month.
500Internal error. Retry later; write to [email protected] if it persists.

Other ways to connect

  • MCP server (npx -y qrlifetime-mcp): lets Claude, Cursor and other AI assistants generate static QR codes offline and manage your dynamic codes with this API. Listed in the official MCP Registry as io.github.mac-from-mcs/qrlifetime.
  • IFTTT: react to scans and change a destination from more than 900 apps, without writing code. It works on Pro, Business and single lifetime codes.
  • Static QR codes in your own backend: snippets in Python, Node and PHP when the destination never changes and you need no redirect at all.
See the Business plan → Manage API keys

Frequently asked questions

Which plan includes the QRLifetime API?

The API is part of the Business plan (€19 per month). Each API key allows 10,000 calls per calendar month (UTC). Static QR codes from the free generator need no API: you can generate them yourself with any QR library.

Do QR codes created through the API stop working if I cancel?

No. The redirect never checks your subscription. If Business ends, your API keys stop working and you can no longer edit the codes, but every code keeps redirecting to the last destination you saved.

Can I choose the slug of a code?

No. The slug is generated by QRLifetime, from an alphabet without look-alike characters (no l, i, o, 0 or 1), so that the short link stays easy to type. The API returns it in the response.

Does the API generate the QR code image?

The API manages the dynamic code: its destination, name, style and scan count. The QR code encodes the shortUrl field, so you can render it with any QR library, or download the styled PNG, SVG or PDF from your dashboard.

Is there a sandbox or test mode?

Not yet. Create a key named "test", point your codes to a page you control, and delete them when you are done. Deleted codes stop redirecting immediately.