Skip to content
GET/qr/wifi

Generate a WiFi join QR code

Builds a WIFI: payload and returns it as a scannable SVG. Scanning it joins the network on both iOS and Android.

Special characters in the SSID and password are escaped as the format requires — without that, a network name containing a semicolon or comma produces a code that quietly fails or joins the wrong network.

$0.0005 per call300 req/minFree allowance applies

Request

curl -X GET "https://www.twotic.dev/v1/qr/qr/wifi" \
  -H "Authorization: Bearer $TWOTIC_KEY"

Parameters

query parameters

NameTypeRequiredDescription
ssidstringrequiredThe network name.e.g. Cafe Guest
passwordstringoptionalThe network password. Omit when encryption is NOPASS.
encryptionstringoptionalSecurity type. Defaults to WPA.one of: WPA · WEP · NOPASS
scaleintegeroptionalPixels per module, 1-40. Defaults to 8.

Response

200The join code as an SVG image.

As an agent tool

Connect https://www.twotic.dev/api/mcp/qr and this endpoint is exposed as the tool qr_wifi.

Generate a QR code that joins a WiFi network when scanned, from an SSID, password and encryption type. Choose this over the general QR tool for network credentials — it builds the WIFI: payload and escapes special characters correctly, which is easy to get wrong by hand. Requires `ssid`; `password` unless encryption is NOPASS.