For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Skip to navigation
- Test print on a printer’s page now queues the short test page: a few lines and a cut, to check the address, the printer and the paper.
- Full test page is a second button. It queues the long page (about 80 cm of paper) with every barcode type, QR code and image.
- The API is as it was:
POST /v1/printers/{printer}/test-print queues the short page, and ?page=full queues the long one. See First connection.
Partners, retries and testing: new page and corrections
- New page: Provision a venue from your software. For a software vendor that sets printers up for its own customers: a customer, a location and a printer through the API, the key and scope of each step, your own ids, safe retries, what to do when the answer that holds the printer URL is lost, handing the URL to the venue, and the first test page.
- SDKs. Both packages call the live API unless you set
baseUrl (TypeScript) or base_url (Python), without /v1. They retry an answer of 408, 429 or 5xx (Python also 409) and wait for Retry-After inside the call, and they do not retry a timeout or a dropped connection: retry that yourself with the same Idempotency-Key and body. See SDKs and Create a print job. The READMEs of the packages say so from the next version.
- Corrections. A
text block of spaces or of a no-break space is accepted and prints a blank-looking line, and a document with no block, or one that prints nothing (blocks of only blank lines, a text block of nothing, a receiptline of only white space), is 422 document_empty. A cut or a rule alone is accepted. A replay of a create returns the object as it is now. A job that the printer has taken stays delivered after expires_at until the printer confirms it, a full queue finishes it as expired, or its bytes are gone (from an hour after expires_at) and the printer’s request for it ends it failed with payload_unavailable: such a job with delivered_at set may have printed. A job that never ends is deleted from 7 days after expires_at. A job past expires_at does not count against the 50 waiting jobs. The full test page is about 80 cm. See Idempotency, Jobs and Errors.
- Testing. There is no safe way to test against the live API today: no test mode, no virtual printers, no webhooks and no preview call over HTTP. Build with an agent says what an agent does instead, and has a brief for an agent that integrates Tillcast into a point of sale.
- Update 2026-10-25. Tillcast has no virtual printers for customers and no test mode.