Skip to main content
V2 Alpha — The V2 API is currently in preview. Breaking changes may occur before the stable release.

​
Overview

The PuppetVendors V2 Vendor API gives vendors direct, secure access to their own data — orders, products, fulfillments, payouts, and more — without going through the merchant. Vendor-scoped tokens are automatically restricted to the authenticated vendor’s data. There is no way for a vendor token to access another vendor’s resources. Base URL: https://api.puppetvendors.com/v2/vendor

​
Getting Started

  1. Get your vendor API key — Your merchant assigns a vendor key (prefixed vk_) to your account
  2. Authenticate — Exchange your key for a JWT token via POST /v2/authenticate
  3. Make requests — Pass the token in the x-access-token header
See the Authentication guide for details.

​
Vendor Resources

Orders

View and export your orders

Products

Create and manage your products

Fulfillments

Create, update, and cancel fulfillments

Payouts

Track your payout history and balances

Dashboard

Sales metrics, charts, and top products

Customers

View customers who have purchased your products

Users

Manage your team’s user accounts

Profile

Update your vendor profile and address

Discounts

Manage your discount codes

Integrations

Connect Shippo, ShipStation, PayPal, and Stripe

​
Rate Limits

The API is rate-limited to 100 requests per minute per IP address. Exceeding this limit returns HTTP 429.

​
Need Help?

Contact support@puppetvendors.com for API access or questions.