> 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.

## The Tillcast API is live

The Tillcast API, the dashboard and the status page are live, and these docs now describe them. The API reference is built from the real contract of the service. It lists the customer operations (customers, locations, printers, jobs, the test print and the organization) with their requests, answers and error codes.

* **API.** `https://api.tillcast.com/v1`, with restricted API keys and six scopes, `Idempotency-Key`, cursor pagination and the `Tillcast-Version` header. The current version is `2026-10-01`.
* **A job carries a ReceiptLine document.** Tillcast renders it into the commands of the printer's profile when it accepts the job, and lists what the renderer noticed in `warnings`. The new page [Receipt documents](/concepts/documents) explains the language and the escape rule for text of your own, with helpers for TypeScript and Python.
* **Printers.** Tillcast supports Star CloudPRNT and Epson Server Direct Print. New pages: [Set up an Epson printer](/printers/epson-setup) and [Profiles and print options](/printers/profiles). [Supported printers](/printers/supported-printers) lists example models and what has run on a device. [Set up a Star printer](/printers/star-setup) says what has been checked on a real printer and what has not.
* **Dashboard.** At [dashboard.tillcast.com](https://dashboard.tillcast.com), sign-up is open and a new organization is active at once. Owners and developers create API keys, customers, locations and printers, and print a test page.
* **Status page.** [status.tillcast.com](https://status.tillcast.com) shows printer connections, printing, the public API and the dashboard. See [Status and incidents](/status).
* **Quickstart.** It now takes you from sign-up to a printed receipt: an API key, a customer, a location, a printer, a job and its status.
* **Rewritten.** The pages that said the service was planned or in a pre-release phase now describe what is live. The rate limits, retention and suspension pages say what exists today.
* **Still planned.** Webhooks and events, test mode, an MCP server for the API and push to printers. They stay marked as planned. See the [roadmap](/roadmap).
* **SDKs:** the TypeScript and Python packages are generated from this contract. They are coming soon as pre-1.0 versions and are not published yet.
* **Update 2026-10-25.** Tillcast has no test mode.