GET /v1/templates

Returns a list of all published templates available to your team, or templates in a specific library.

Endpoint:

GET /v1/templates

Authentication

Authorization: Bearer bp_sk_live_YOUR_KEY

Query Parameters

Parameter	Type	Description
`library`	`string`	Optional. Filter by library slug (e.g., `carbon`). Returns only templates from that library.

Response

Status: 200 OK

{
  "templates": [
    {
      "id": "abc123",
      "name": "Shipping Label",
      "slug": "shipping-label",
      "dimensions": { "width": "4in", "height": "6in" },
      "tags": ["shipping"],
      "publishedAt": 1711843200000
    },
    {
      "id": "def456",
      "name": "Product 2x1",
      "slug": "product-2x1",
      "librarySlug": "carbon",
      "dimensions": { "width": "2in", "height": "1in" },
      "tags": ["labels"],
      "publishedAt": 1711756800000
    }
  ]
}

Response Fields

Field	Type	Description
`templates`	`array`	Array of template metadata objects.
`templates[].id`	`string`	Template ID.
`templates[].name`	`string`	Template name.
`templates[].slug`	`string`	Template slug. For team templates, use this directly as `templateId`.
`templates[].librarySlug`	`string`	Library slug (present only for library templates). Use `librarySlug:slug` as `templateId` (e.g., `carbon:product-2x1`).
`templates[].dimensions`	`object`	Template dimensions (`width`, `height`, optional `safeMargin`).
`templates[].tags`	`string[]`	Organizational tags.
`templates[].publishedAt`	`number`	Publish timestamp (milliseconds since epoch).

Examples

List team templates

curl -H "Authorization: Bearer bp_sk_live_YOUR_KEY" \
  https://api.binderypress.dev/v1/templates

List library templates

curl -H "Authorization: Bearer bp_sk_live_YOUR_KEY" \
  "https://api.binderypress.dev/v1/templates?library=carbon"

Errors

Status	Code	Cause
`401`	`AUTH_REQUIRED`	Missing or invalid API key.