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

MethodEndpointDescription
POST
/organizations/:orgId/qr-codes/bulk-importStart a bulk import from CSV
GET
/organizations/:orgId/qr-codes/bulk-importList all import jobs
GET
/organizations/:orgId/qr-codes/bulk-import/:idGet import job status
GET
/organizations/:orgId/qr-codes/bulk-import/sampleDownload CSV template
POST
/organizations/:orgId/qr-codes/batch/updateBatch update multiple QR codes
POST
/organizations/:orgId/qr-codes/batch/cloneClone multiple QR codes
DELETE
/organizations/:orgId/qr-codes/batchDelete multiple QR codes

CSV Bulk Import

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

1

Download the CSV template

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

curl -X GET \
  "https://i-love-qr-production-645dbff8d2fe.herokuapp.com/api/v1/organizations/org_abc123/qr-codes/bulk-import/sample?type=URL" \
  -H "X-API-Key: YOUR_API_KEY" \
  -o template.csv
2

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
3

Upload the CSV file

Send the file to start the import job.

Start Import
curl -X POST \
  "https://i-love-qr-production-645dbff8d2fe.herokuapp.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"
4

Monitor import progress

Check the status of your import job.

curl -X GET \
  "https://i-love-qr-production-645dbff8d2fe.herokuapp.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

ColumnRequiredDescription
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

ColumnRequiredDescription
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://i-love-qr-production-645dbff8d2fe.herokuapp.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: