QR Code Generator API

Generate QR code images by appending .qr.png to any Linkly short link. No authentication or API key required.

The image is returned as a PNG with all saved QR code styles applied, including custom colors, dot patterns, eye styles, and logos.

Append .qr.png to any Linkly short link:

https://your-domain.com/ABC123.qr.png

This returns a 1024x1024 PNG image of the QR code. If you've customized the QR code's colors, style, or logo in Linkly, those styles are automatically applied.

Embed a QR code in an HTML page:

<img src="https://your-domain.com/ABC123.qr.png" alt="QR Code" />

Or use it in an email template, a PDF, or any system that supports image URLs.

Pass query parameters to override the link's saved QR styles or change the image size:

https://your-domain.com/ABC123.qr.png?qrStyle=dots&fgColor=%23009eff&size=2048

Note: hex colors must be URL-encoded — use %23 in place of # (e.g. %23ff0000 for #ff0000).

Logo dimensions are automatically scaled to match the requested image size.

The quietZone adds whitespace padding around the entire QR code, filled with bgColor. This is useful when printing QR codes on dark backgrounds — without it, the positioning eyes sit flush against the edge and may not scan reliably. For example, quietZone=50&bgColor=%23ffffff adds a 50-pixel white border.

You can save QR code styles to a link when creating or updating it via the Link Shortening API. Pass a qr_styles JSON object with any of the style keys listed above:

{
  "api_key": "your_api_key",
  "workspace_id": 1234,
  "url": "https://example.com",
  "qr_styles": {
    "fgColor": "#009eff",
    "bgColor": "#ffffff",
    "qrStyle": "dots",
    "eyeStyle": "rounded",
    "logoImage": "https://example.com/logo.png",
    "logoWidth": 60,
    "logoHeight": 60,
    "logoPadding": 10,
    "logoStyle": "circle",
    "quietZone": 50
  }
}

Once saved, these styles are automatically applied whenever you request the .qr.png image — no query parameters needed.

QR code styles are resolved in the following order:

1. 1Default styles — Black foreground on transparent background, square modules, 1024px
2. 2Saved styles — Any customizations you've made in the QR code editor or set via the Link API are stored with the link
3. 3Query parameter overrides — Override individual styles per request via URL parameters

When a logo is present, Linkly automatically uses high error correction (Level H) to ensure the QR code remains scannable.

The endpoint is rate limited to 5 requests per second per IP address. Images are cached for 5 minutes, so repeated requests for the same QR code are served quickly.

A successful request returns a 200 status with Content-Type: image/png and the PNG image data as the response body.

Error responses return JSON:

{"error": "Rate limit exceeded"}

• Create QR Codes - How to create and customize QR codes in Linkly
• Add a Logo to a QR Code - Create branded QR codes with your company logo
• SVG QR Codes - Download QR codes in scalable vector format
• Link Shortening API - Create and manage links programmatically
• Analytics API - Export click data and traffic reports