API Documentation

Bulk Operations

Bulk Create QR Codes

Automate the creation of your QR codes with our API. Create hundreds or thousands of QR codes at once, perfect for large campaigns, product labeling, or asset tracking.

CSV Import

Upload a CSV file with your QR code data and we'll create them all at once.

API Batch

Create multiple QR codes in a single API call with JSON payload.

Async Processing

Large imports run in the background with status tracking.

Endpoints

Method	Endpoint	Description
POST	/organizations/:orgId/qr-codes/bulk-import	Start a bulk import from CSV
GET	/organizations/:orgId/qr-codes/bulk-import	List all import jobs
GET	/organizations/:orgId/qr-codes/bulk-import/:id	Get import job status
GET	/organizations/:orgId/qr-codes/bulk-import/sample	Download CSV template
POST	/organizations/:orgId/qr-codes/batch/update	Batch update multiple QR codes
POST	/organizations/:orgId/qr-codes/batch/clone	Clone multiple QR codes
DELETE	/organizations/:orgId/qr-codes/batch	Delete multiple QR codes

CSV Bulk Import

The easiest way to create many QR codes at once is via CSV import. Follow these steps:

Download the CSV template

Get the template for your QR code type to ensure proper formatting.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv

Fill in your data

Add your QR code data to the CSV file. Here's an example for URL QR codes:

url_qr_codes.csv

name,url,folder,tags
Homepage QR,https://example.com,Marketing,homepage;main
Product Page,https://example.com/product,Products,product;featured
Contact Us,https://example.com/contact,Marketing,contact;support
Promo Landing,https://example.com/promo,Campaigns,promo;summer2024

Upload the CSV file

Send the file to start the import job.

Start Import

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@url_qr_codes.csv" \
  -F "type=URL"

Monitor import progress

Check the status of your import job.

curl -X GET \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/import_abc123" \
  -H "X-API-Key: YOUR_API_KEY"

Response

{
  "id": "import_abc123",
  "status": "COMPLETED",
  "type": "URL",
  "totalRows": 100,
  "processedRows": 100,
  "successCount": 98,
  "errorCount": 2,
  "errors": [
    { "row": 45, "error": "Invalid URL format" },
    { "row": 72, "error": "Name is required" }
  ],
  "createdAt": "2024-01-15T10:00:00Z",
  "completedAt": "2024-01-15T10:02:30Z"
}

CSV Column Reference

Each QR code type requires different columns. Here are the most common ones:

URL QR Codes

Column	Required	Description
name	Required	Display name for the QR code
url	Required	Destination URL (must start with http:// or https://)
folder	Optional	Folder name to organize the QR code
tags	Optional	Tags separated by semicolons

vCard QR Codes

Column	Required	Description
name	Required	Display name for the QR code
firstName	Required	Contact's first name
lastName	Required	Contact's last name
email	Optional	Email address
phone	Optional	Phone number
company	Optional	Company name
title	Optional	Job title

Batch Update

Update multiple QR codes at once with a single API call.

POST

/organizations/:orgId/qr-codes/batch/update

Batch Update Request

curl -X POST \
  "https://api.iloveqr.com/api/v1/organizations/org_abc123/qr-codes/batch/update" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["qr_abc123", "qr_def456", "qr_ghi789"],
    "updates": {
      "folderId": "folder_xyz",
      "style": {
        "foregroundColor": "#1D59F9"
      }
    }
  }'

Import Limits

Maximum Rows

10,000

QR codes per CSV file

File Size Limit

10 MB

Maximum CSV file size

Tip: For very large imports (10,000+ QR codes), consider splitting your CSV into multiple files and importing them sequentially.

Use Cases

Product Labeling

Generate unique QR codes for every product in your inventory

Marketing Campaigns

Create personalized QR codes for each recipient

Asset Tracking

Label equipment, documents, or physical assets

Event Management

Generate tickets or badges with unique QR codes

Next Steps

Learn about related features: