---
title: "Print Labels"
method: POST
path: "/v1/label-templates/{id}/print"
tags: ["Label Templates"]
---

# Print Labels

`POST /v1/label-templates/{id}/print`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/label-templates/{id}/print`
- Auth: API key in header `Authorization`

## Path parameters

- `id` string, required

## Request body

- V1LabelTemplatePrintRequest
  - `copies` integer: Default copies per label (used if item.quantity is 0)
  - `itemIds` string[]: Simple list (1 copy each) - for backward compatibility
  - `items` V1LabelPrintItem[]: Items with individual quantities
    - `id` string, required
    - `quantity` integer: Number of copies for this item

## Response `200`

OK

- V1LabelTemplatePrintResponse
  - `labelCount` integer
  - `message` string
  - `success` boolean

## Changes

- **2026-10-31** `c75bd57db3c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sysadminsmedia/apis/homebox-api/changes/v1/label-templates/:id/print/post.md)

---

[API](https://skmtc.dev/sysadminsmedia/apis/homebox-api.md) - [All operations](https://skmtc.dev/sysadminsmedia/apis/homebox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sysadminsmedia/apis/homebox-api/revisions/316b3e623d70?raw)