Docs

Print orders

Fulfillment API for authorized print partners. Uses print-partner tokens, not catalog nameCode keys.

Auth

Send the partner token as a Bearer header (issued in Admin for a Print Partner). Catalog vm_ keys are rejected here.

Authorization: Bearer <print-partner-token>

List orders

GET/api/partners/v1/orders

Returns up to 100 recent orders for your partner account.

• orderId, status, title, sku, quantity
• shipTo — address fields only (no buyer email or payment data)
• trackingNumber, carrier, externalId
• createdAt, updatedAt

curl -s https://vilomedia.com/api/partners/v1/orders \
  -H "Authorization: Bearer …"

Create order

POST/api/partners/v1/orders

Body (JSON). Email and payment fields in shipTo are dropped.

{
  "title": "Ashen Vein Vol. 1 tankōbon",
  "sku": "VM-MG-TANKO",
  "quantity": 1,
  "shipTo": { "name": "…", "street1": "…", "city": "…", "country_code": "US" },
  "externalId": "your-ref-123"
}

Ship / tracking

POST/api/partners/v1/orders/:orderId/ship

Attach carrier and tracking when the job leaves your facility.

Onboarding

Print partnership is separate from catalog manufacturer access. Contact partners@vilomedia.com.