Get Template

Returns the full details of a single QR code design template identified by its ID.

GET /v1/qr/templates/{template_id}

qr:read

Parameters

Path parameters

Parameter	Type	Required	Description
template_id	string	Yes	The unique identifier of the template.

Request examples

curl

curl https://xqr.co/api/v1/qr/templates/tpl_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

TypeScript

const templateId = "tpl_abc123";

const res = await fetch(
  `https://xqr.co/api/v1/qr/templates/${templateId}`,
  {
    headers: {
      Authorization: "Bearer YOUR_API_KEY",
    },
  }
);

const { data, meta } = await res.json();

Python

import httpx

template_id = "tpl_abc123"

res = httpx.get(
    f"https://xqr.co/api/v1/qr/templates/{template_id}",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)

template = res.json()["data"]

Response

200 OK

{
  "data": {
    "id": "tpl_abc123",
    "name": "Brand Primary",
    "description": "Main brand QR style with purple dots and rounded corners",
    "design": {
      "foreground_color": "#8B5CF6",
      "background_color": "#FFFFFF",
      "error_correction": "H",
      "dot_style": "rounded",
      "corner_style": "rounded",
      "logo_url": "https://cdn.xqr.co/logos/brand.png",
      "logo_size": 0.25,
      "quiet_zone": 2
    },
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-02-20T14:00:00Z"
  },
  "meta": {
    "request_id": "req_3d8f2c",
    "rate_limit": {
      "remaining": 96,
      "reset_at": "2026-03-21T12:01:00Z"
    }
  }
}