Generate a QR code for arbitrary data
Render a QR code for any text or URL payload. Returns image/png bytes by default, or a base64 data URL in the standard envelope when format=json. Script-execution URL schemes (javascript:, data:, vbscript:, …) are rejected with 400; rendering runs fully in-cluster — the payload never leaves the platform.
Authorizations
Dashboard JWT token from Clerk
Headers
Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Query Parameters
Payload to encode (plain text or a URL, max 2048 chars). Must not start with a script-execution URL scheme such as javascript: or data:.
1 - 2048Image edge length in pixels (50–1024, default 300). The output PNG is always square.
50 <= x <= 1024png (default) returns raw image/png bytes; json returns the standard envelope with data.qr_data_url as a base64 data URL.
png, json Response
Rendered QR code as PNG image bytes (content-type image/png). Pass format=json to receive a base64 data-URL in the standard { data, meta } envelope instead.
The response is of type file.