List Templates

Retrieve a list of all design templates in your workspace. Templates store reusable QR code designs (frame, colors, dots, corners, logo) that you can apply when creating or updating QR codes.

GET/templates

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
search	string	—	Filter templates by name (optional)

Request

cURL

curl -X GET "https://integration-api.qr-build.com/templates" \
  -H "X-API-Key: qrb_live_your_api_key_here"

JavaScript

const response = await fetch(
  "https://integration-api.qr-build.com/templates",
  { 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/templates",
    headers={"X-API-Key": "qrb_live_your_api_key_here"},
)

data = response.json()

Response

{
  "object": "list",
  "success": true,
  "data": [
    {
      "id": "tpl-aBc123XyZ9",
      "name": "Brand Style",
      "design": {
        "builderData": { "dotsOptions": { "color": "#212B36" } },
        "frameData": { "type": "simple-text", "text": "Scan me!" }
      },
      "created_at": "2026-02-16T10:30:00Z",
      "updated_at": "2026-02-16T10:30:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
id	string	Unique template identifier
name	string	Template name
design	object	QR design (builderData, frameData) — use as design when creating/updating QR codes
created_at	string	ISO 8601 creation timestamp
updated_at	string	ISO 8601 last update timestamp