List QR code scans
curl --request GET \
--url https://api.awardee.com/v1/qr-codes/{id}/scans \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.awardee.com/v1/qr-codes/{id}/scans', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.awardee.com/v1/qr-codes/{id}/scans"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"has_more": true,
"next_cursor": "<string>",
"data": [
{
"object": "qr_scan",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"qr_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scanned_at": "2023-11-07T05:31:56Z",
"user_agent": "<string>",
"destination": {
"type": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>"
},
"query_params": {},
"location": {
"country": "<string>",
"region": "<string>",
"city": "<string>"
}
}
]
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}Endpoints
List QR code scans
Cursor-paginated scan history, newest first. Each row is an immutable snapshot of the destination and visitor metadata at scan time.
GET
/
qr-codes
/
{id}
/
scans
List QR code scans
curl --request GET \
--url https://api.awardee.com/v1/qr-codes/{id}/scans \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.awardee.com/v1/qr-codes/{id}/scans', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.awardee.com/v1/qr-codes/{id}/scans"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"has_more": true,
"next_cursor": "<string>",
"data": [
{
"object": "qr_scan",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"qr_code_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"scanned_at": "2023-11-07T05:31:56Z",
"user_agent": "<string>",
"destination": {
"type": "<string>",
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"url": "<string>"
},
"query_params": {},
"location": {
"country": "<string>",
"region": "<string>",
"city": "<string>"
}
}
]
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}{
"error": "<string>",
"message": "<string>",
"request_id": "<string>",
"details": "<unknown>",
"retry_after": 123
}Authorizations
Send your API key as Authorization: Bearer aw_live_…. Manage keys in the dashboard under Settings → API Keys.
Path Parameters
A QR code's UUID or its public slug.

