API Documentation

Complete reference for the QRWolf REST API

OpenAPI SpecImport to PostmanGet API Access

Quickstart

Get up and running with the QRWolf API in under five minutes. This guide walks you through creating your first API key, listing your QR codes, creating a new one, and downloading the image — all from the command line or your language of choice.

1

Create an API Key

Head to the API dashboard and click "Create Key". Give it a name like "Development" and copy the key — you will only see it once. Store it somewhere safe, like an environment variable.

export QRWOLF_API_KEY="qw_live_abc123...your_key_here"
2

List Your QR Codes

Make your first API call. This returns all QR codes in your account, most recent first.

curl -s "https://qrwolf.com/api/v1/qr-codes?limit=5" \
  -H "Authorization: Bearer $QRWOLF_API_KEY" | jq .

Expected response

{
  "data": {
    "qr_codes": [...],
    "total": 12,
    "limit": 5,
    "offset": 0
  }
}
3

Create a QR Code

Create a dynamic QR code pointing to any URL. Dynamic codes let you change the destination later without reprinting.

curl -X POST "https://qrwolf.com/api/v1/qr-codes" \
  -H "Authorization: Bearer $QRWOLF_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First API QR",
    "content": {
      "type": "url",
      "url": "https://example.com"
    }
  }'

Expected response

{
  "data": {
    "id": "a1b2c3d4-...",
    "name": "My First API QR",
    "redirect_url": "https://qrwolf.com/r/abc123",
    "content": {
      "type": "url",
      "url": "https://example.com"
    }
  }
}
4

Download the Image

Grab the QR code as a PNG or SVG file. Replace the UUID with the id from the previous step.

curl -s "https://qrwolf.com/api/v1/qr-codes/YOUR_QR_ID/image?size=512" \
  -H "Authorization: Bearer $QRWOLF_API_KEY" \
  --output my-qr-code.png

echo "Saved to my-qr-code.png"

What's Next?

You've just created and downloaded your first QR code via the API. From here, explore the full endpoint reference to add styling, set up webhooks for real-time scan notifications, or use bulk create to generate hundreds of codes at once.