Skip to navigation

Welcome to Tillcast

A print API for receipt printers.
View as Markdown

Tillcast is a print API for receipt printers. Your software sends a print job over HTTPS, and a printer in the venue picks it up and prints it. The printer connects to Tillcast by itself, so the venue needs no VPN and no local print server.

The call your software makes for every receipt is Create a print job: POST /v1/printers/{printer}/jobs, with an API key that has the scope jobs:write, a body that carries the receipt, and an Idempotency-Key header. The body has document, an array of blocks (the recommended way), or receiptline, text in ReceiptLine for documents written for other ReceiptLine tools: exactly one of the two. See Receipt documents for every block. Start there if you have an API key and a printer, and with the quickstart if you do not.

If you are an AI agent or you build with one: read Build with an agent first, and treat the docs as the source of truth. The index of all pages is llms.txt, and every page is also Markdown when you add .md to its address.

Live

The API is live at https://api.tillcast.com/v1. The dashboard at dashboard.tillcast.com is open for sign-up, and the status page is at status.tillcast.com. You can create an organization, an API key, customers, locations and printers, and print. An AI assistant can do the same through the MCP server, with an API key: see Connect an AI assistant (MCP).

What is not available yet: webhooks and events, a template language and stored templates, OAuth sign-in for the MCP server, OAuth connections and connectors for Make, Zapier and n8n, sign-in with Google, push to printers, and printers that do not poll the server themselves. Do not write code that depends on them. See the roadmap.

Two printer technologies are supported: Star CloudPRNT and Epson Server Direct Print. What has run on a real printer is listed in Supported printers, and the paper checks of the newest receipts are still being done. The API is early, so read the changelog when you update your integration.

Who Tillcast is for

Tillcast is for software vendors whose software must print on receipt printers in venues such as hotels and restaurants. Examples are property management systems and point-of-sale systems. Tillcast calls such a vendor an organization. See the concepts overview.

Tillcast is not an app for venues. A venue’s staff install a printer with a URL that your software gives them.

What you will find here

Also: the API reference, the status page, the roadmap and the changelog.

Contact

To ask for help or to report a problem, write to contact@tillcast.com. When the question is about an API call, quote the request_id of the error (see Errors).