GET /printers/{path}

Returns a single printer by its path (URL-encoded). The response shape matches a single element from the GET /printers array, including status and statusReasons.

Endpoint:

GET /api/v1/printers/{path}

Path Parameter

Parameter	Type	Description
path	string	The printer’s path value, URL-encoded. For example: tcp%3A%2F%2F192.168.86.250%3A9100 or tcp_192-168-86-250_9100.

Response

{
  "status": "success",
  "statusCode": 200,
  "result": {
    "module": "/printers/tcp_192-168-86-250_9100",
    "message": "Printer retrieved.",
    "content": {
      "id": "MYS9QT8D",
      "type": "printer",
      "path": "tcp_192-168-86-250_9100",
      "connection": {
        "type": "network",
        "host": "192.168.86.250",
        "port": 9100,
        "protocol": "tcp"
      },
      "model": "Zebra ZD421",
      "content": "zpl",
      "discovered": false,
      "localAddress": "192.168.86.250",
      "status": "online",
      "statusReasons": []
    }
  }
}

See GET /printers for the full field reference.

Error: 404 — Printer Not Found

{
  "status": "error",
  "statusCode": 404,
  "result": {
    "module": "/printers/tcp_192-168-99-99_9100",
    "message": "Printer not found",
    "content": {
      "message": "No printer with path: tcp_192-168-99-99_9100"
    }
  }
}