API & Integrations

Connect ImprimeBay to your management software with our REST API. Read orders, update statuses and manage your catalog from your system. Available with the Premium plan.

Authentication

Generate your API key from the dashboard settings (Integrations section). Include it in every request in the Authorization header:

Authorization: Bearer ib_live_xxxxxxxxxxxxx

Base URL: https://imprimebay.com/api/v1/public

Endpoints

GET/orders

List your orders. Optional filter ?status=SHIPPED

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/orders

GET/orders/:id

Order detail, with status history.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/orders/ORDER_ID

PATCH/orders/:id/status

Update an order status. Values: ACCEPTED, IN_PRODUCTION, READY, READY_PICKUP, SHIPPED, DELIVERED, CANCELED

curl -X PATCH -H "Authorization: Bearer ib_live_..." \
  -H "Content-Type: application/json" \
  -d '{"status":"SHIPPED"}' \
  https://imprimebay.com/api/v1/public/orders/ORDER_ID/status

GET/products

List your catalog products.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/products

GET/products/:id

Product detail.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/products/PRODUCT_ID

PATCH/products/:id

apiDocs.ep_productUpdate

curl -X PATCH -H "Authorization: Bearer ib_live_..." \
  -H "Content-Type: application/json" \
  -d '{"isActive":false}' \
  https://imprimebay.com/api/v1/public/products/PRODUCT_ID

GET/stats

Statistics: total orders, paid, revenue, by status.

curl -H "Authorization: Bearer ib_live_..." \
  https://imprimebay.com/api/v1/public/stats

Note: each key accesses only its own print shop data. Requests are limited to 30 per minute. The key can be regenerated or revoked anytime from the dashboard.