Here you can find basic information about the API. All other technical API documentation can be found in portal.print.one.

📄️ API Documentation

In this help center, you will mainly find information on graphical aspects, delivery specifications, links to data platforms, and other explanations.

📄️ Authentication and API Keys

Authentication with the API is done using API keys. For API requests, the API key can be sent along in the headers. The header key for this is x-api-key.

📄️ Example JSON

Note: Where 'tmpl_12345678900987654321' appears, the template ID should be entered.

📄️ API status codes

All status codes starting with a 2 (e.g. 201) represent success.

📄️ Address Validation

The Print.one API has support for address validation whenever you try to make a request. There is a general address validation which is done for all countries, but also address validation for some specific countries. You will find details on all of these validations below.

📄️ Rate Limiting

Unless otherwise stated in the API documentation, all endpoints have a rate limit of 60 requests every 30 seconds.

📄️ Idempotency

Our API supports idempotency for safely retrying requests without accidentally performing the same operation twice. When creating or updating an object (order, template), use an idempotency key. If a connection error then occurs, you can safely retry the request without risking creating a second object (order, template) or performing the update twice.

📄️ Postman settings

Postman is an application which is used by many developers to test API's. In a lot of cases you do not need Postman. In most marketing platforms certain features are present to test API requests / webhooks.


📄️ CSV automation

With CSV files, you have an alternative way to submit orders. Each row in the CSV is considered as a new order.