Automate QR Code Creation
with Our API

Get your API key

Log in to PurpleQR, open Settings → API Keys and create a new key. Copy and store it securely — it's shown only once.

POST to /v1/create

Send a JSON body with your apikey and the data you want to encode. Customise colours, patterns, and frames via optional fields.

Receive SVG + ID

The response includes a vector SVG string and a qrid you can use to retrieve or delete the QR later.

curl -X POST https://api.purpleqr.com/v1/create \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "pqr_your_api_key_here",
    "data": "https://purpleqr.com",
    "title": "Homepage QR",
    "frontcolor": "#4B2D8F",
    "backcolor": "#FFFFFF",
    "pattern": "dots",
    "outer_frame": "scanme",
    "framelabel": "SCAN ME"
  }'

{
  "success": true,
  "qrid": "clxyz1234abcd",
  "svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" ...>...</svg>"
}

curl -X POST https://api.purpleqr.com/v1/delete \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "pqr_your_api_key_here",
    "qrid": "clxyz1234abcd"
  }'

{ "success": true }

curl -X POST https://api.purpleqr.com/v1/list \
  -H "Content-Type: application/json" \
  -d '{
    "apikey": "pqr_your_api_key_here",
    "pagination": 1
  }'

{
  "success": true,
  "total": 42,
  "data": [
    {
      "id": "clxyz1234abcd",
      "title": "Homepage QR",
      "data": "https://purpleqr.com",
      "qrType": "static",
      "scanCount": 17,
      "createdAt": "2026-08-01T10:00:00.000Z"
    }
    // … up to 100 items per page
  ]
}