List QR Codes

Retrieve a paginated list of your QR codes.

GET /api/v1/qrcodes

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number (1-based)
limit	integer	20	Items per page (1–100)
type	string	—	Filter by QR type (url, text, etc.)
is_dynamic	string	—	Filter: "true" or "false"
search	string	—	Search in name and content
sort	string	"newest"	Sort order: newest, oldest, name-asc, name-desc

Example Request

curl "https://api.qbar-scanner.com/api/v1/qrcodes?page=1&limit=10&type=url&sort=newest" \
  -H "X-API-Key: qbar_your_key_here"

Response 200 OK

{
  "data": [
    {
      "id": "uuid-1",
      "name": "My Website",
      "type": "url",
      "content": "https://example.com",
      "style_config": "{}",
      "folder_id": null,
      "is_dynamic": true,
      "status": "active",
      "scans": 42,
      "short_code": "aB3cD4eF",
      "dynamic_url": "https://qbar-scanner.com/r/aB3cD4eF",
      "image_url": "https://api.qbar-scanner.com/api/v1/qrcodes/uuid-1/image",
      "created_at": "2025-01-15T10:30:00.000Z",
      "updated_at": "2025-01-15T10:30:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 47,
    "total_pages": 5
  },
  "request_id": "..."
}

Pagination

Use pagination.total_pages to know how many pages exist. To get the next page:

GET /api/v1/qrcodes?page=2&limit=10