API v1.0

Developer Portal

The fastest way to integrate professional QR generation into your workflow. RESTful, secure, and built for scale.

Getting Started

Welcome to the FreeQRCodeGen API. Our API follows REST principles and uses JSON for all request and response bodies. Every endpoint is reached via HTTPS to ensure data integrity and security.

BASE URL
https://freeqrcodegen.online/api/v1

Authentication

Authorize your requests by including your API key in the `X-API-KEY` header. Keep this key secret—anyone with it can generate QRs on your behalf.

HEADER EXAMPLES
X-API-KEY: your_secure_api_key_here
Content-Type: application/json
POST /generate

Generate QR Code

The primary endpoint for creating static QR codes. This returns a JSON response containing the QR image data in Base64 or an SVG string.

curl -X POST "https://freeqrcodegen.online/api/v1/generate" \
  -H "X-API-KEY: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "data": "https://google.com",
    "type": "url",
    "size": 500,
    "fg_color": "#5B5FEF"
  }'

Request Parameters

Parameter
Type
Status
Description
data
string
Required
The content to encode (URL, Text, etc)
type
string
Required
url, vcard, wifi, text, upi
size
integer
Optional
Size in pixels (100 - 2000)
fg_color
hex
Optional
Hex code for foreground
bg_color
hex
Optional
Hex code for background
format
string
Optional
png (default), svg
POST /save-qr

Save QR to Account

Generates a QR code and automatically saves it to your dashboard. This is required if you want to track analytics or use dynamic destination URLs.

curl -X POST "https://freeqrcodegen.online/api/v1/save-qr" \
  -H "X-API-KEY: YOUR_KEY" \
  -d '{
    "data": "https://yourlink.com",
    "type": "url",
    "dynamic": true,
    "name": "Spring Campaign 2024"
  }'
GET /analytics/{short_code}

Fetch Scan Data

Retrieve detailed scan statistics for any dynamic QR code in your account, including device types, countries, and daily scan counts.

curl -G "https://freeqrcodegen.online/api/v1/analytics/abcd123" \
  -H "X-API-KEY: YOUR_KEY" \
  -d "days=7"

Error Handling

Our API uses standard HTTP response codes to indicate the success or failure of an API request.

400
Bad Request — Your request has invalid parameters.
401
Unauthorized — Your API key is invalid or missing.
404
Not Found — The requested resource doesn't exist.
429
Too Many Requests — You have hit your rate limit.
500
Server Error — Something went wrong on our end.

Usage Limits

We believe in open developers. Our free tier allows generous experimentation before needing a pro plan.

Free Tier
500
req/month
Pro Member
50k
req/month
Enterprise
∞
Custom Limits