---
search:
  tags:
    - Printing
    - POST
seo:
  description: >-
    Any signed in user. Records a receipt, invoice, credit note, label, or…
    Reference for the POST /api/v1/printing/print-jobs endpoint in the
    PharmaFlow API.
sidebar:
  label: Record a print job
  badge: POST
title: Record a print job
type: openapi-operation
---
Any signed in user. Records a receipt, invoice, credit note, label, or report as printed. A named printer must share the branch, and the legacy printed status reads back as completed.

`POST /api/v1/printing/print-jobs`

**Request body** (`application/json`, required)

- `branch_id` (string)
- `printer_id` (string | null)
- `document_type` (string)
- `reference_id` (string, required)
- `copies` (number)
- `status` (string)
- `reason` (string)

Request body example:

```json
{
  "branch_id": "string",
  "printer_id": "string",
  "document_type": "string",
  "reference_id": "string",
  "copies": 0,
  "status": "string",
  "reason": "string"
}
```

**Responses**

- `201` — Print job recorded
- `400` — reference\_id is empty, the document type or status is invalid, copies is not an integer between 1 and 20, or the printer belongs to another branch
- `401` — Not authenticated
- `403` — Branch is outside your ownership
- `404` — Printer not found

Response example, 201:

```json
{
  "id": "string",
  "branch_id": "string",
  "printer_id": "string",
  "document_type": "string",
  "reference_id": "string",
  "copies": -9007199254740991,
  "status": "string",
  "reason": "string",
  "created_by": "string",
  "created_at": "string"
}
```