Receiptful - Receipt Printing API

Send HTML, get a receipt

POST an HTML snippet to our API. Your thermal printer renders it — tables, images, QR codes and all.

<h3 align="center">The Green Bean</h3>
<p align="center">123 Main St</p>
<hr>
<table width="100%">
  <tr>
    <td>Cappuccino</td>
    <td align="right">$4.50</td>
  </tr>
  <tr>
    <td>Croissant</td>
    <td align="right">$3.25</td>
  </tr>
  <tr>
    <td><b>Total</b></td>
    <td align="right"><b>$7.75</b></td>
  </tr>
</table>
<hr>
<p align="center">
  <img src="x-qrcode:https://example.com" width="30%"/>
  <br>
  Thanks for visiting!
</p>
<cut>

The Green Bean

123 Main St

Cappuccino	$4.50
Croissant	$3.25
Total	$7.75

Thanks for visiting!

Quick start

# Get your API key
curl -X POST https://api.receiptful.io/v1/users

# Register a printer
curl -X POST https://api.receiptful.io/v1/printers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"label": "Kitchen"}'

# Install the Android app and enter the login code

# Print an HTML receipt
curl -X POST https://api.receiptful.io/v1/printers/1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"html": "<h3>Hello World</h3><p>Your receipt here</p><cut>"}'

Or send raw ESC/POS bytes

# Print with raw ESC/POS (base64-encoded)
curl -X POST https://api.receiptful.io/v1/printers/1/jobs \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "BASE64_ESCPOS_BYTES"}'

Features

HTML rendering

Tables, images, QR codes, and barcodes — send HTML, we handle the rest.

REST API

Simple JSON endpoints with full OpenAPI documentation.

Raw ESC/POS

Full protocol support for when you need low-level control.

Android app

Lightweight (~5 MB), Bluetooth connectivity, push notifications.

No drivers needed

Connect your thermal printer over Bluetooth. No setup hassle.

Job tracking

Poll job status via the API. Webhooks coming soon.

Receiptful.