---
title: "Queues the standardised test label (ITE-618) so a newly configured queue can be checked without printing a real prescription. It travels the same path as a real label — same geometry source, same S3 upload, same PrintJob, same gateway — because a test that bypassed the pipeline would not prove the pipeline works."
method: POST
path: "/api/Printers/test-print"
tags: ["Printers"]
---

# Queues the standardised test label (ITE-618) so a newly configured queue can be checked without printing a real prescription. It travels the same path as a real label — same geometry source, same S3 upload, same PrintJob, same gateway — because a test that bypassed the pipeline would not prove the pipeline works.

`POST /api/Printers/test-print`

## Request

- Base URL: `https://api.clinicos.vet/backend/business`
- URL: `https://api.clinicos.vet/backend/business/api/Printers/test-print`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/docs/api/Printers/test-print/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- PrintTestLabelRequestDto
  - `printerName` string
  - `format` string, nullable: Which label stock to test against. Null falls back to the bottle label, matching TemplateFormatSpec.For — a test print should produce something rather than 400.

## Response `200`

OK

- PrintLabelResultDto
  - `printJobId` string
  - `status` string

## Other responses

- `400`: Bad Request

## Changes

- **2026-09-02** `061f8d95e1d1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/changes/api/Printers/test-print/post.md)

---

[API](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1.md) - [All operations](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/clinicos/apis/pawthosx-business-api-v1/revisions/099cf36186e0?raw)