Ready2order

Ready2order Printer API

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.

Documentation GitHub OpenAPI

Operations 3

GET /printer List printers #

GET /printer/{id} Get a printer #

POST /printer/testPrint Send a test print #

Documentation

📖

Documentation

https://ready2order.com/api/doc

📖

APIReference

https://ready2order.com/api/doc

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/ready2order/refs/heads/main/openapi/ready2order-printer-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/ready2order-printer-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: ready2order Public Printer API
  contact:
    name: support@ready2order.com
  license:
    name: proprietary
  version: R2-2026.30.2
  description: '# First Steps


    ## Authorization


    The ready2order API uses a three-token flow to grant your integration access to a ready2order account.'
servers:
- url: https://api.ready2order.com/v1
tags:
- name: Printer
  description: Printers represent the physical printing devices registered to an account — including receipt printers, mobile printers, and all-in-one terminals.
paths:
  /printer:
    get:
      tags:
      - Printer
      summary: List printers
      description: Returns all printers registered to the account.
      operationId: printerGetAll
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  properties:
                    printer_id:
                      type: integer
                      example: 123
                    printer_name:
                      type: string
                      example: kitchen printer
                    printer_description:
                      type: string
                      example: kitchen printer
                    printer_deviceName:
                      type: string
                      example: EPSON-TM-T88V
                    printer_model:
                      type: string
                      example: TM-T20II
                    printer_manufacturer:
                      type: string
                      example: EPSON
                    printer_ipAddress:
                      type: string
                      example: 192.168.0.1
                    printer_characters:
                      type: integer
                      example: 42
                    printer_doubleHeight:
                      type: boolean
                      example: true
                    printer_createdAt:
                      type: string
                      example: '2019-01-01 11:11:11'
                  type: object
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - Bearer: []
  /printer/{id}:
    get:
      tags:
      - Printer
      summary: Get a printer
      description: Returns a single printer by its ID.
      operationId: printerFindById
      parameters:
      - name: id
        in: path
        description: Printer ID to find
        required: true
        schema:
          type: integer
          example: 123456
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                properties:
                  printer_id:
                    type: integer
                    example: 123
                  printer_name:
                    type: string
                    example: kitchen printer
                  printer_description:
                    type: string
                    example: kitchen printer
                  printer_deviceName:
                    type: string
                    example: EPSON-TM-T88V
                  printer_model:
                    type: string
                    example: TM-T20II
                  printer_manufacturer:
                    type: string
                    example: EPSON
                  printer_ipAddress:
                    type: string
                    example: 192.168.0.1
                  printer_characters:
                    type: integer
                    example: 42
                  printer_doubleHeight:
                    type: boolean
                    example: true
                  printer_createdAt:
                    type: string
                    example: '2019-01-01 11:11:11'
                type: object
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      security:
      - Bearer: []
  /printer/testPrint:
    post:
      tags:
      - Printer
      summary: Send a test print
      description: Sends a test page to the account's configured default printer. If no default printer is configured, the test is sent to all printers on the account.
      operationId: printerTestPrint
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                properties:
                  error:
                    type: boolean
                    example: true
                  success:
                    type: boolean
                    example: false
                  msg:
                    type: string
                    example: Printer not found
                type: object
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
      security:
      - Bearer: []
components:
  securitySchemes:
    Bearer:
      type: apiKey
      description: Account Token obtained after completing the authorization flow. See First Steps for details.
      name: Authorization
      in: header
x-tagGroups:
- name: Essentials
  tags:
  - Product
  - Product Group
  - Bill
  - Storno
  - Payment Method
  - Payment Method Type
  - Coupon
  - Coupon Category
  - Discount
  - Discount Group
  - Customer
- name: Gastro
  tags:
  - Order
  - Table
  - Table Area
- name: POS
  tags:
  - Printer
  - Printer Profile
  - Print Job
  - Terminal Transaction
  - User
  - User Roles
- name: Reporting
  tags:
  - Daily Report
  - Accounting Financial Year
  - Export
- name: Reference Data
  tags:
  - Bill Type
  - Customer Group
  - Currency
  - Country
  - Device
  - Language
  - Legal Form
  - Units
  - Vat Rate
- name: Integration
  tags:
  - Account Token
  - Grant Access Token
  - Developer Token
  - Webhook
  - Job Status
- name: Internal
  tags:
  - Account
  - Admin
  - CashboxRegistration
  - ConfirmableAction
  - Constant
  - Item
  - License
  - MobileConstant
  - ReadyPaySellRate
  - Signup
  - Tss