# Printeers API documentation

> Developer documentation for the Printeers partner API, a REST API for selling print-on-demand phone cases and tech accessories: product catalog and stock, mockup rendering, order creation and tracking, claims and webhooks.

Links ending in `.md` are the markdown version of a guide; the same URL without `.md` is the HTML page. The full text of all guides is in [llms-full.txt](https://api-docs.test-printeers.com/llms-full.txt). The OpenAPI specifications are the source of truth for endpoints, parameters and schemas; the HTML reference pages render the same files.

## OpenAPI specifications

- [Printeers API v2](https://api-docs.test-printeers.com/static/printeers-api-v2.openapi.json): the current API, use this for every new integration
- [Printeers webhooks](https://api-docs.test-printeers.com/static/printeers-webhooks.openapi.json): the event payloads delivered to webhook endpoints
- [Printeers API v1](https://api-docs.test-printeers.com/static/printeers-api-v1.openapi.json): the legacy API, in its deprecation period

## Guides

- [Getting Started](https://api-docs.test-printeers.com/guides/getting-started.md): Learn how to set up your integration with the Printeers API.
- [Organization Structure](https://api-docs.test-printeers.com/guides/organization-structure.md): Learn how your organization is structured with accounts, stores, and brands.
- [Shipments and Tracking](https://api-docs.test-printeers.com/guides/shipments-and-tracking.md): Understand how orders become shipments and what tracking information is available.
- [API Versioning](https://api-docs.test-printeers.com/guides/api-versioning.md): Understand how Printeers versions the API, the release cycle, and what to expect when upgrading.
- [Pagination](https://api-docs.test-printeers.com/guides/pagination.md): Learn how to paginate through large result sets using cursors.
- [Items, Products, and SKUs](https://api-docs.test-printeers.com/guides/items-products-and-skus.md): Understand how physical stock items relate to orderable products, how SKUs work, and how to migrate from SKU-based to reference-based integrations.
- [Products](https://api-docs.test-printeers.com/guides/products.md): Learn how products are organized and priced.
- [Creating Orders](https://api-docs.test-printeers.com/guides/creating-orders.md): Learn how to create orders through the API, including image uploads, shipping options, and address handling.
- [Claims](https://api-docs.test-printeers.com/guides/claims.md): Learn how to file and manage claims for shipment issues such as missing packages, damaged items, or print defects.
- [Rendering](https://api-docs.test-printeers.com/guides/rendering.md): Learn how to create product mockup renders using scenes, perspectives, and compositions.
- [Rate Limiting](https://api-docs.test-printeers.com/guides/rate-limiting.md): Learn how per-organization rate limits work, how to read the response headers, and how to react to a 429.
- [Webhooks](https://api-docs.test-printeers.com/guides/webhooks.md): Receive signed event notifications on your own endpoint the moment something happens on the Printeers platform, instead of polling the API.
- [V1 vs V2](https://api-docs.test-printeers.com/guides/v1-vs-v2.md): If you're moving from V1 to V2, this page is a quick orientation.

## Optional

- [Printeers website and support knowledge base](https://test-printeers.com/llms.txt): products, pricing, shipping and Dashboard how-to articles