Skip to main content
Build integrations with the PRINTOOLS public REST API. Use it to read and manage quotes, jobs, customers, catalogue items, and the other resources listed in this reference.

​
Base URL

https://api.printools.io Every endpoint on this tab is generated from the published OpenAPI specification. Expand a resource in the sidebar to see its operations, request parameters, response schemas, and code examples.

​
Make your first request

Create a key in Settings → API in the PRINTOOLS app. Keep it on your server.
A tenant key is bound to one shop. It does not require an organisation header. Partner credentials use a different combination of headers.

Authentication

Authenticate with a tenant key or partner credentials.

Get current account

Check the organisation, credential, and scopes for your request.

Scopes

Find the permissions required by each operation.

Writing safely

Use idempotency keys when retrying writes.

​
Try an endpoint

Open an endpoint page, enter your credentials, and inspect its request and response schema before sending a request.
Requests sent from the API playground reach the production API. Write operations can change your shop’s data.

​
Download the contract

Download OpenAPI JSON to import the API into your client or generate an SDK. This reference documents the operations in that specification.