# Free QR code API

> Put https://qr.cuelark.com/v1/qr?data=YOUR_TEXT in an img tag or call it from code, and you get a PNG or SVG QR code back. No key is needed, and responses are cached at the edge.

URL: https://qr.cuelark.com/qr-code-api

## Make a code
```bash
curl -o qr.png 'https://qr.cuelark.com/v1/qr?data=https%3A%2F%2Fexample.com&size=512'

# SVG, brand color, rounded modules
curl 'https://qr.cuelark.com/v1/qr?data=hello&format=svg&fg=1e3a8a&style=rounded'
```

## Structured codes with POST
```bash
curl -X POST https://qr.cuelark.com/v1/qr \
  -H 'content-type: application/json' \
  -d '{"type":"wifi","fields":{"ssid":"Guest","password":"espresso2026"},"format":"svg"}'
```

## Read a code
```bash
curl -X POST https://qr.cuelark.com/v1/decode -H 'content-type: image/png' --data-binary @code.png
# {"found":true,"text":"https://example.com","type":"url","summary":"Link: https://example.com"}
```

## Limits
- Generation: free, 240 requests per minute per IP; identical GET requests are served from cache.
- Decoding: 200 images per day per IP, images up to 4 MB and 16 megapixels.
- Inputs aren't stored or logged. Full reference on the API docs page.

## FAQ
### Do I need an API key?
No. Free API keys with higher limits are coming with Cuelark accounts.

### Can I hotlink the image?
Yes. Use the URL directly in an img tag or Markdown. It's cached at the edge, so it's fast.

### Does the API support logos?
Not yet. Logos are supported in the browser generator, which embeds them in the PNG or SVG.