API Reference & Integration

Introduction to the Lifetime QR Codes API

The Lifetime QR Codes API allows developers to programmatically interact with our platform. Whether you need to generate thousands of QR codes for an inventory system, automate the update of redirect URLs, or pull scan analytics into your own BI dashboard, our RESTful API provides the infrastructure to do it at scale.

Authentication

All API requests require an API Key. You can generate and manage your keys from the API section in your account settings.

Authorization: Bearer YOUR_API_KEY

Keep your API keys secure. Do not share them in public repositories or client-side code.

Base URL

All API endpoints are hosted on the following base URL:

https://api.lifetimeqrcodes.com/v1

Authentication

Include your API Key in the Authorization header for all requests:

Authorization: Bearer YOUR_API_KEY

Core Endpoints

POST /qrcodes

Create a new dynamic or static QR code.

{ "type": "dynamic", "destination": "https://yoursite.com/page", "name": "Product Label 001", "folder": "inventory" }

GET /qrcodes/{id}

Retrieve details and current destination of a specific code.

GET https://api.lifetimeqrcodes.com/v1/qrcodes/qr_abc123

PATCH /qrcodes/{id}

Update the destination URL or content of an existing dynamic code.

{ "destination": "https://yoursite.com/new-page", "name": "Updated Label" }

GET /analytics/{id}

Fetch real-time scan data, including geolocation and device info.

GET https://api.lifetimeqrcodes.com/v1/analytics/qr_abc123

Bulk QR Code Generation

To generate multiple QR codes at scale, make sequential POST /qrcodes requests or use batch operations. For very large volumes (1000+), we recommend:

CSV Upload: Use the dashboard bulk uploader for 1000-50,000 codes
API Loop: Make multiple POST /qrcodes calls within rate limits
Webhooks: Monitor completion status via webhook notifications
Enterprise Plan: Contact support for custom bulk integration

Rate Limits

To ensure platform stability, we apply rate limits based on your plan:

Starter: 10 requests per minute
Business: 100 requests per minute
Enterprise: Custom limits based on usage needs

Rate limit information is included in response headers: X-RateLimit-Limit,X-RateLimit-Remaining, and X-RateLimit-Reset.

Webhook Support

You can configure Webhooks to receive real-time notifications when a scan occurs. This allows you to trigger automated workflows in external apps like Zapier, Salesforce, or your custom internal CRM.

Webhook Event: scan.recorded

{ "event": "scan.recorded", "qrcode_id": "qr_abc123", "timestamp": "2026-04-09T15:30:45Z", "geolocation": { "country": "US", "region": "California", "city": "San Francisco" }, "device": { "type": "mobile", "os": "iOS", "browser": "Safari" } }

Error Handling

The API returns standard HTTP status codes. Common errors:

400 Bad Request: Invalid parameters or malformed request
401 Unauthorized: Missing or invalid API key
403 Forbidden: You lack permission to access this resource
404 Not Found: The requested QR code or resource doesn't exist
429 Too Many Requests: Rate limit exceeded
500 Server Error: Something went wrong on our end

Need Help?

Have questions about the API? Contact our developer support team:

📧 Email: support@qrtrac.com
📞 Phone: +1 (505) 361-3164
💬 Support hours: Monday-Friday, 9am-5pm MST