List QR Codes

Retrieve a paginated list of all QR codes in your workspace.

GET/qr-codes

info

List responses return a lightweight representation of each QR code without content and design fields. Use the Get QR Code endpoint to retrieve the full object.

Headers

Header	Required	Description
X-API-Key	Required	Your API key
QR-Version	Optional	API version (e.g., 2026-02-16)

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number (starts at 1)
limit	integer	20	Items per page (max 100)
search	string	—	Search by name
type	string	—	Filter by QR code type
folder_id	string	—	Filter by folder ID (only QR codes in this folder)

Pagination

Field	Type	Description
page	integer	Current page number
limit	integer	Items per page
total	integer	Total number of QR codes
has_more	boolean	Whether more pages exist

Request

cURL

curl -X GET "https://integration-api.qr-build.com/qr-codes?page=1&limit=10&type=url" \
  -H "X-API-Key: qrb_live_your_api_key_here"

JavaScript

const params = new URLSearchParams({
  page: "1",
  limit: "10",
  type: "url",
});

const response = await fetch(
  `https://integration-api.qr-build.com/qr-codes?${params}`,
  { headers: { "X-API-Key": "qrb_live_your_api_key_here" } }
);

const data = await response.json();

Python

import requests

response = requests.get(
    "https://integration-api.qr-build.com/qr-codes",
    headers={"X-API-Key": "qrb_live_your_api_key_here"},
    params={"page": 1, "limit": 10, "type": "url"},
)

data = response.json()

Response

{
  "object": "list",
  "success": true,
  "data": [
    {
      "id": "qr-aBc123XyZ9",
      "name": "My Website QR",
      "type": "url",
      "active": true,
      "folder_id": "fld-aBc123XyZ9",
      "folder_name": "Marketing Campaign",
      "short_url": "https://qr-build.io/qr-aBc123XyZ9",
      "created_at": "2026-02-16T10:30:00Z",
      "updated_at": "2026-02-16T10:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 45,
    "has_more": true
  }
}