V2 Alpha — The V2 API is currently in preview. Breaking changes may occur before the stable release.
Overview
The PuppetVendors V2 Merchant API is a complete redesign of the public REST API, built for performance and flexibility. It introduces cursor-based pagination, dual authentication scopes, and standardised error handling. Base URL:https://api.puppetvendors.com/v2
What’s New in V2
| Feature | V1 | V2 |
|---|---|---|
| Pagination | Offset-based (page/limit) | Cursor-based (Relay-style first/after/last/before) |
| Auth Scopes | Single merchant token | Merchant and vendor-scoped tokens |
| Error Format | Varied | Consistent { success, error: { message, code } } |
| Fulfillments | Create only | Full CRUD (create, update, cancel) |
| Products | Read only | Full CRUD (create, update, delete) |
| Reports | Single endpoint | Paginated detail + summary |
Authentication
All V2 endpoints use JWT tokens obtained viaPOST /v2/authenticate. Tokens are passed in the x-access-token header.
Merchant tokens provide full access to all shop data and all vendors.
See the Authentication guide for details.
Merchant Resources
Authentication
JWT tokens with merchant scope
Vendors
Full vendor CRUD with profile and address management
Orders
Retrieve orders with cursor-based pagination
Products
Full product CRUD with Shopify sync
Fulfillments
Create, update, and cancel fulfillments
Payouts
Track vendor payout balances and summaries
Commissions
Vendor and SKU-level commission management
Dashboard
Aggregated sales and fulfillment metrics
Customers
Customer directory with vendor scoping
Discounts
Discount code management
Line Items
Bulk line item updates
Reports
Vendor sales reports with summaries