Twilee Docs

Scans Resource

List Scans for a QR Code

Endpoint

GET /qr_codes/{id}/scans

Description
Retrieve all scan logs for a given QR code.
Each scan entry includes a timestamp and country information.

Example Request

curl -X GET "https://api.twilee.com/qr_codes/68cdbbe0ed096c7b590277c6/scans"   -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "@context": "/contexts/ScanLog",
  "@id": "/qr_codes/68cdbbe0ed096c7b590277c6/scans",
  "@type": "Collection",
  "totalItems": 7,
  "member": [
    {
      "@id": "/scan_logs/68d026db486dd2e1ae0ad518",
      "@type": "ScanLog",
      "datetime": "2025-09-21T16:24:59+00:00",
      "qrCode": "/qr_codes/68cdbbe0ed096c7b590277c6",
      "country": "FR"
    }
  ]
}

Pagination

GET /qr_codes/{id}/scans?page=2