EasyPick API

EasyPick API connects an e-shop to EasyPick pickup boxes. Your server reserves a compartment, receives a six-digit PIN, and tracks subsequent changes through webhooks or the shipment status endpoint.

Environment	Base URL	Use
Sandbox	https://sandbox-api.easypick.cz/v1	Development and automated integration tests
Production	https://api.easypick.cz/v1	Real boxes and shipments

Caution

Sandbox and production API keys are separate. A key starting with ep_test_ cannot be used in production, and an ep_live_ key cannot be used in the sandbox.

Typical integration

1. Create an API key and configure a webhook in the tenant administration.
2. Use GET /boxes to discover an available box ID.
3. Call POST /shipments when creating an order.
4. Return the PIN to your order process. EasyPick uses it for loading and customer pickup.
5. Track state through webhooks and reconcile uncertain outcomes with GET /shipments/{id}.

Public v1 contract

The /v1 API uses JSON, UTC timestamps in RFC 3339 format, and stable English status values. It never exposes internal tenant, device, or door identifiers.

• Quickstart
• Shipment lifecycle
• Interactive API reference
• Download OpenAPI JSON