Get Template

Retrieve a single template by ID. Use the returned design object when creating or updating QR codes to apply the template's design.

GET/templates/:id

Headers

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

Request

cURL

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

JavaScript

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

data = response.json()

Response

{
  "object": "template",
  "success": true,
  "data": {
    "id": "tpl-aBc123XyZ9",
    "name": "Brand Style",
    "design": {
      "builderData": { ... },
      "frameData": { ... }
    },
    "created_at": "2026-02-16T10:30:00Z",
    "updated_at": "2026-02-16T10:30:00Z"
  }
}

Using a Template When Creating a QR Code

Pass data.design as the design parameter in Create QR Code:

{
  "name": "My QR",
  "content": { "type": "url", "data": "https://example.com" },
  "design": { "builderData": {...}, "frameData": {...} }
}