API Reference

Generate QR codes on demand via HTTP. No authentication required. All responses are image files.

https://qr.espos.nl/{type}[.{format}]?{params}

Content Types

TypeRequired paramsOptional params
textdata
urlurl
emailtosubject, body
telnumber
smsnumberbody
geolat, lngalt
wifissidpass, enc (WPA/WEP/nopass), hidden
vcardnameorg, phone, email, url, address, note
mecardnamephone, email, url
otpauthsecretissuer, account, type (totp/hotp), digits, period
sepaname, ibanbic, amount, ref, msg, purpose
eventsummary, startend, location, desc
bookmarkurltitle

Output Formats

Append the format as a file extension. Default is .svg.

ExtensionMIME typeNotes
.svgimage/svg+xmlDefault. Scalable, ideal for print and screen
.pngimage/pngRaster. Use scale param to set pixel size
.webpimage/webpModern raster, smaller file size
.jpgimage/jpegJPEG raster
.gifimage/gifGIF raster
.avifimage/avifModern format, best compression
.epsapplication/postscriptVector, for professional print workflows

Style Parameters

These apply to all content types and formats.

ParamValuesDefaultDescription
eccL, M, Q, HHError correction level
scale1–4010Pixel size per module (raster only)
margin0–104Quiet zone width in modules
darkhex (no #)000000Dark module colour
lighthex (no #)ffffffLight / background colour
invert0, 10Swap dark and light colours
circles0, 10Render modules as circles
version1–40autoForce a specific QR version

Examples

Simple URL (SVG)

https://qr.espos.nl/url?url=https://espos.nl

URL as PNG, custom colours

https://qr.espos.nl/url.png?url=https://espos.nl&ecc=H&dark=1a1a2e&scale=12

WiFi credentials

https://qr.espos.nl/wifi?ssid=HomeNetwork&pass=MyPass&enc=WPA

SEPA payment

https://qr.espos.nl/sepa?name=Jan+Jansen&iban=NL91ABNA0417164300&amount=19.99&msg=Invoice+001

vCard contact

https://qr.espos.nl/vcard?name=Jan+Jansen&phone=%2B31612345678&email=jan@espos.nl

Inverted with round modules

https://qr.espos.nl/url?url=https://espos.nl&invert=1&circles=1

OTP authenticator

https://qr.espos.nl/otpauth?secret=BASE32SECRET&issuer=eSPOS&account=user@espos.nl