QR Codes

Get a QR code for a link

Renders a QR image for a link in the caller's workspace. The image encodes the short URL with ?flyn_qr=1 appended so scans are counted in qrScans; the response reports the clean shortUrl.

Auth: API key (Bearer flyn_sk_live_...) or an MCP OAuth access token (Bearer flyn_mcp_at_...). The dashboard session cookie is not accepted.

Plan: PNG in the default colours on every plan. format=svg or any colour other than fg #14532D on bg #FFFFFF needs Pro, Lifetime or Team (a member of a paying owner's workspace has the effective plan team); Free gets 403 UPGRADE_REQUIRED. Any team role.

Rate limit: 60 requests per 60 s per client IP, fixed window, in memory per server instance, checked before authentication.

In a query string the # of a colour must be sent as %23.

get/api/links/{id}/qr

Request

  • Base URL: https://www.flyn.to
  • URL: https://www.flyn.to/api/links/{id}/qr
  • Auth: HTTP bearer

Query parameters

format'png' | 'svg'

Image format, case-sensitive. svg is Pro.

sizenumber

Target width in px, clamped to 64..2048 and rounded. The output snaps down to whole modules. Non-numeric is 400.

marginnumber

Quiet zone in modules, clamped to 4..32.

level'L' | 'M' | 'Q' | 'H'

Error correction, upper-cased first.

fgstring

Foreground colour (send # as %23). Non-default is Pro; equal to bg is 400.

bgstring

Background colour (send # as %23). Non-default is Pro.

Response

The rendered QR code.

shortUrlstring uri required

The clean short URL. The image itself encodes this URL plus ?flyn_qr=1, the scan marker behind qrScans.

qrDataUrlstring required

data:image/png;base64,..., or data:image/svg+xml;base64,... for SVG.

svgstring

SVG markup; present only when format=svg.

Changes

No recorded changes to this operation across all 1 revision of this API.