Getting started
Connect Twilee directly with your own tools and workflows.
With an API key, your team can bring Twilee’s power directly into your tech stack — automate QR code generation, capture live scan data, and integrate intelligent tracking into your products, all with just a few lines of code.
Overview
- Each team can create one API Key.
- The API currently supports read-only operations (
GET
requests). - All endpoints return data in JSON format.
- Pagination is supported for collection endpoints.
Base URL
https://api.twilee.com
Authentication
All requests must include your API key as a Bearer token in the Authorization header.
Example:
GET /qr_codes HTTP/1.1
Host: api.twilee.com
Authorization: Bearer YOUR_API_KEY
Accept: application/json
Available Endpoints
Resource | Description | Methods |
---|---|---|
/qr_codes |
List all QR codes | GET |
/qr_codes/{id} |
Retrieve a specific QR code | GET |
/qr_codes/{id}/scans |
List scans for a QR code | GET |
/qr_codes/{id}/page-views |
List page views for a QR code | GET |
Example Request
curl -X GET "https://api.twilee.com/qr_codes" -H "Authorization: Bearer YOUR_API_KEY" -H "Accept: application/json"
Example Integration (JavaScript)
const response = await fetch('https://api.twilee.com/qr_codes', {
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Accept': 'application/json'
}
});
const data = await response.json();
console.log(data.member);
Error Handling
Code | Meaning | Description |
---|---|---|
200 |
OK | Request succeeded |
401 |
Unauthorized | Missing or invalid API key |
404 |
Not Found | The requested resource does not exist |
429 |
Too Many Requests | Rate limit exceeded |
500 |
Server Error | An unexpected error occurred |
✅ You’re all set!
Use your API key to fetch QR code analytics, monitor engagement, and keep your apps in sync with your Twilee dashboard.