> Tillcast is live: the API at https://api.tillcast.com/v1 and the dashboard at https://dashboard.tillcast.com. A key prints on real printers, so do not call the API unless asked. A job carries its receipt as "document", an array of blocks (the recommended way), or as "receiptline", ReceiptLine text, exactly one of the two: read https://docs.tillcast.com/create-a-print-job.md and https://docs.tillcast.com/concepts/documents.md before you write a job body. Do not code against what does not exist yet: webhooks, a template language, stored templates (a job has no template field), OAuth connections and connectors for Make, Zapier and n8n, and OAuth sign-in for the MCP server. SDKs for TypeScript (@tillcast/sdk, version 0.2.0 or later for blocks) and Python (tillcast) exist as pre-1.0 versions. To show a receipt in a web page without printing, there are the npm packages @tillcast/preview and @tillcast/html-render (0.x, no API key, no call to Tillcast to draw): read https://docs.tillcast.com/preview-a-receipt.md. The docs are the source of truth: check the index https://docs.tillcast.com/llms.txt and https://docs.tillcast.com/roadmap.md before you code against anything. For clean Markdown of any page, append .md to the page URL. The Tillcast MCP server is live at https://api.tillcast.com/mcp and takes an API key as a bearer token (setup: https://docs.tillcast.com/connect-an-ai-assistant.md). It acts on the live account and its tools print on real paper, so do not connect to it or call its tools unless the owner asked you to. The MCP server at https://docs.tillcast.com/_mcp/server is a different one: it only searches these docs and cannot call the Tillcast API.

# Welcome to Tillcast

> Tillcast is a print API for receipt printers, for software vendors. The API, the dashboard, the status page and the TypeScript and Python SDKs are live.

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**](/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](/concepts/documents) for every block. Start there if you have an API key and a printer, and with the [quickstart](/quickstart) if you do not.

If you are an AI agent or you build with one: read [Build with an agent](/build-with-an-agent) first, and treat the docs as the source of truth. The index of all pages is [llms.txt](https://docs.tillcast.com/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](https://dashboard.tillcast.com) is open for sign-up, and the status page is at [status.tillcast.com](https://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)](/connect-an-ai-assistant).
>
> **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](/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](/printers/supported-printers), and the paper checks of the newest receipts are still being done. The API is early, so read the [changelog](/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](/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

#### [Create a print job](/create-a-print-job)

The request, the answer, what happens next, retrying safely and the usual refusals, in cURL, TypeScript and Python.

#### [Quickstart](/quickstart)

From sign-up and an API key to a first receipt in your hand.

#### [Provision a venue from your software](/provision-a-venue)

For a software vendor that sets printers up for its customers: a customer, a location and a printer through the API, handing over the printer URL and the first test page.

#### [Concepts](/concepts/overview)

Organization, customer, location, printer and job, and how a printer connects.

#### [Receipt documents](/concepts/documents)

How to write what you print: blocks for text, tables, bold and size, barcodes, QR codes and images.

#### [Using the API](/api/authentication)

Authentication, versioning, idempotency, errors, pagination and limits.

#### [Printers](/printers/supported-printers)

Which printers work, how to set up a Star or an Epson printer and what to do when it does not connect.

#### [Security and data](/security)

Where data lives, how long it is kept and how organizations are kept apart.

#### [Build with an agent](/build-with-an-agent)

How a coding agent reads these docs.

Also: the [API reference](/api-reference), the [status page](/status), the [roadmap](/roadmap) and the [changelog](/changelog).

## Contact

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