List all your printers

List printers

GET https://www.expedy.fr/api/v2/printers/all

Returns all the cloud printers attached to your account, with their UID, name, status and configuration. Use it to discover the printer_uid you need to send a print job.

Base URL: https://www.expedy.fr/api/v2

Authentication

This endpoint requires an Authorization header containing your SID and TOKEN, separated by a single colon.

Authorization: <SID>:<TOKEN>

⚠️ This is not a Bearer token. Do not add a Bearer or Basic prefix — send the raw SID:TOKEN value.

Both values are available in the Expedy console under API. All requests must be made over HTTPS (TLS).

cURL example:

curl "https://www.expedy.fr/api/v2/printers/all" \
  -H "Authorization: <SID>:<TOKEN>"

Response `200 OK`

Returns a JSON array of printer objects (empty array if no printer is registered).

Field	Type	Description
`printer_uid`	`string`	Unique identifier of the printer. This is the value you pass as `{printer_uid}` to the print endpoint.
`printer_name`	`string`	Human-readable label set in the console (e.g. `Kitchen`, `Lobby`).
`printer_status`	`string`	Activation state of the printer. `1` = active, `0` = suspended. This is an administrative flag controlled solely by ExpedyPRINT — not a live connectivity indicator.
`printer_width`	`string`	Paper width in millimetres: `58`, `80` or `104`. Use it to size your content (32 / 48 characters per line for 58 / 80 mm).
`printer_graphic_mode`	`string`	Image rendering mode configured in the console: `0` = Graphics (default), `1` = BitImageRaster, `2` = BitImageColumn. See Image and Logo.
`printer_print_mode`	`string`	Numeric code for the printer's print mode (device-specific configuration).

ℹ️ printer_status is an activation flag, not a real-time connectivity check. 0 means the printer has been suspended by ExpedyPRINT — usually because of a billing issue or a breach of our Terms of Service — and it will not print until reactivated. To verify that an active device is physically reachable and printing, send a test print rather than relying on this field.

Response example:

[
  {
    "printer_uid": "UP3VS5JXRYA",
    "printer_name": "Lobby",
    "printer_status": "1",
    "printer_width": "58",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "MMAAZ112PI",
    "printer_name": "Kitchen",
    "printer_status": "1",
    "printer_width": "80",
    "printer_graphic_mode": "0",
    "printer_print_mode": "0"
  },
  {
    "printer_uid": "8L35EGFH8S7",
    "printer_name": "Warehouse",
    "printer_status": "1",
    "printer_width": "104",
    "printer_graphic_mode": "0",
    "printer_print_mode": "1"
  }
]

Errors

Any non-2xx status returns a JSON envelope with a message field:

{
  "message": "Missing ExpedyPRINT API credentials (SID / token)."
}

Status	Meaning
`401` / `403`	Missing or invalid credentials (`SID` / `TOKEN`).

Always read the message field rather than relying on the status code alone.

Next step

Once you have a printer_uid, send content to it:

POST https://www.expedy.fr/api/v2/printers/{printer_uid}/print

See the print endpoint reference for the request body and layout tags.

SDK & examples

Prefer a ready-made client? Use the official Node.js SDK — it wraps authentication and printer listing:

👉 github.com/ExpedyDev/expedy-sdk-node