# Ready2order Printer API

**Canonical:** https://apis.io/apis/ready2order/ready2order-printer-api/  
**Provider:** Ready2order — https://apis.io/providers/ready2order/  
**Base URL:** https://api.ready2order.com/v1  
**Documentation:** https://ready2order.com/api/doc

Ready2order Printer API is one of 36 APIs that [Ready2order](https://apis.io/providers/ready2order/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Printer. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

<!-- markdownlint-disable MD041 MD051 github-internal-links relative-links -- tag description snippet, not a standalone document; the tag name serves as the heading in the API docs --> Printers represent the physical printing devices registered to an account — including receipt printers, mobile printers, and all-in-one terminals. They are configured through the ready2order POS or dashboard; the public API is read-only except for triggering a test print. **Fields** | Field | Description | |-------|-------------| | `printer_id` | System-assigned unique identifier for the printer | | `printer_name` | The name assigned to the printer in the account settings | | `printer_description` | Optional free-text description | | `printer_deviceName` | The OS-level device name used to address the printer | | `printer_model` | The hardware model, for example `TM-T20II` or `mC-Print3` | | `printer_manufacturer` | The manufacturer, for example `epson` or `star` | | `printer_ipAddress` | **Deprecated.** The connection address for the printer: an IP address for network printers, a MAC address for Bluetooth, a device path (e.g. `/dev/usb/lp0`) for USB, or `ready2print` for OS-managed printers. `null` if not yet configured | | `printer_characters` | The number of characters per printed line, which determines print width | | `printer_doubleHeight` | Whether characters are printed at double height | | `printer_createdAt` | Timestamp when the printer record was created | **Printer profiles** A printer profile (see [Printer Profile](#tag/Printer-Profile)) is a named logical slot that sits between your POS configuration and a physical printer. Assigning print jobs to a profile rather than to a printer directly means you can swap out hardware without reconfiguring the rest of the system. Each profile lists the physical printer IDs it currently maps to in `printingProfile_associatedPhysicalPrinterIds`. **Cash drawer** Some printers support opening a connected cash drawer via an RJ11 kick signal. This is configured per printer in the account settings. See the [create bill](#operation/billCreateBill) endpoint for how to trigger it via the API.

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| GET | `/printer` | List printers |
| GET | `/printer/{id}` | Get a printer |
| POST | `/printer/testPrint` | Send a test print |

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/ready2order/refs/heads/main/openapi/ready2order-printer-api-openapi.yml
- **Documentation** — https://ready2order.com/api/doc
- **APIReference** — https://ready2order.com/api/doc

## Other Ready2order APIs (12)

- [Ready2order Account Token API](https://apis.io/apis/ready2order/ready2order-account-token-api/)
- [Ready2order Accounting Financial Year API](https://apis.io/apis/ready2order/ready2order-accounting-financial-year-api/)
- [Ready2order Bill API](https://apis.io/apis/ready2order/ready2order-bill-api/)
- [Ready2order Bill Type API](https://apis.io/apis/ready2order/ready2order-bill-type-api/)
- [Ready2order Country API](https://apis.io/apis/ready2order/ready2order-country-api/)
- [Ready2order Coupon API](https://apis.io/apis/ready2order/ready2order-coupon-api/)
- [Ready2order Coupon Category API](https://apis.io/apis/ready2order/ready2order-coupon-category-api/)
- [Ready2order Currency API](https://apis.io/apis/ready2order/ready2order-currency-api/)
- [Ready2order Customer API](https://apis.io/apis/ready2order/ready2order-customer-api/)
- [Ready2order Customer Group API](https://apis.io/apis/ready2order/ready2order-customer-group-api/)
- [Ready2order Daily Report API](https://apis.io/apis/ready2order/ready2order-daily-report-api/)
- [Ready2order Device API](https://apis.io/apis/ready2order/ready2order-device-api/)

## Tags

Printer

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ready2order/ready2order-printer-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ready2order/.
