Version 2
Printags API documentation
This is the official API documentation for Printags: PVC, NFC and wood cards, printed and encoded. If you have any questions, please contact us at [email protected]. Authentication: send your API key as a Bearer token, Authorization: Bearer <key>. Keys are created in the dashboard and act on the account that holds them. Live keys start with sk_live_: their orders are real, debited and manufactured. Test keys start with sk_test_: their orders are test orders, never debited and never manufactured, and a test key only sees test orders (a live key only sees real ones); use simulateOrderStatus to move a test order through its life cycle and receive the same webhooks as in production. Four routes need no key: listOrderStatuses, listShippingCarriers, calculateShippingRates and getFile. Errors: a failed call answers with a non-2xx status and the JSON body described by the Error schema (success: false, a machine-readable code, a message). Pagination: listOrders is the only list that pages (the other lists return everything). Walk it with a cursor: call it with limit, then again with cursor set to the pagination.next_cursor of the page before, until has_more is false and next_cursor null; page and per_page (offset) keep working. Long-running work: a firm order is queued, not made, by createOrder; send Prefer: respond-async to get 202 Accepted with a Location to poll (getJob), which answers the job's status (pending, running, succeeded, failed) and a Retry-After. Rate limit: 1200 calls per minute per API key, and 6000 per minute per IP address for the calls without a key; every response of a limited operation carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (the X-RateLimit-* forms too), and a 429 RATE_LIMITED carries Retry-After; the file download (getFile) is not limited. Version 2 serves the routes of version 1 under /v2, with the names of the platform: an order's items (version 1 product_groups) and units (version 1 products, the cards), the catalogue's products (version 1 models, productId for modelId) and shipments (version 1 shippings). Version 1 is deprecated since 25 October 2026 and will be removed on 4 January 2027.
Endpoints
Schemas
Error Account Address Customer Product Unit Item SubscriptionPlan Shipment ShippingCarrier ShippingRate ShippingEnvelope Order NFC Job FileUpload UploadedFile Quote Webhook
Questions
How do I get a Printags API key?
Create an account at dashboard.printags.com/register, then create an API key in the dashboard. No call with sales is needed.
Is there a sandbox?
Yes. A test key (sk_test_) creates test orders that are neither charged nor manufactured, on https://sandbox-api.printags.com or on the production server. A test key only sees test orders.
What are the rate limits?
1200 calls per minute per API key, and 6000 per minute per IP address for the calls without a key. Responses carry RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset headers, and a 429 RATE_LIMITED carries Retry-After.
Is there an SDK?
Yes, two: the npm package printags, an SDK and a command line for Node.js 18 or later, and the PyPI package printags, an SDK for Python 3.9 or later (pip install printags). Any other language calls the REST API described by the OpenAPI document.
Can an AI assistant use the API?
Yes, through the Printags MCP server at https://mcp.printags.com, with a Printags account (OAuth) or an API key in an Authorization: Bearer header.
For agents and tools
- OpenAPI document (JSON) and YAML
- llms.txt and llms-full.txt
- MCP server for integrators
- Printags app in ChatGPT
- Every page has a Markdown twin: add
.mdto its URL