Introduction
PuppetVendors API enables you to manage all your shop resources programmatically. Be it getting access to your vendors, users, shops, payouts, fulfillment, or commissions.
The PuppetVendors API follows the general patterns of REST.
What made this section unhelpful for you?
Base URL
Production:
https://api.puppetvendors.com/
What made this section unhelpful for you?
Errors
PuppetVendors API uses the following status or error codes.
The API rate limit is 100 requests per minute.
What made this section unhelpful for you?
Status Codes
200
Everything worked as expected.
400
The request was unacceptable, often due to missing a required parameter.
401
The request was unacceptable, often due to missing a required parameter.
402
The parameters were valid but the request failed.
403
The API key doesnt have permissions to perform the request.
404
The requested resource does not exist.
429
You have made too many consecutive requests. Please slow down and try again later.
500
We had a problem with our server. Try again later.
422
Incomplete data is provided to perform an action.
What made this section unhelpful for you?
Authentication
PuppetVendors uses API keys to allow access to the API. Access to the API is only available to shops on the Enterprise plan.
You must exchange your API key for a JWT token used for making direct API calls to your shop resources within PuppetVendors.
| Title | Required? | Type | Description | Min Length | Max Length |
|---|---|---|---|---|---|
| apiKey | true | string | Unique API Key | ||
| shopDomain | true | string | Unique Shopify Domain |
Both apiKey and shopDomain can be found in the API Access navigation under Settings.
PuppetVendors expects the JWT token to be included in all subsequent API requests to the server in a header.
Each JWT token is valid for 12 hours.
Header Parameters
Body Parameters
Response
Response Attributes
Response Attributes
Response Attributes
Response Attributes
Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJfaWQiOiI2MTU3ZmFkZGJlYmNmMDFiZjQ5MDk3ZDgiLCJzaG9wRG9tYWluIjoibGlseWRhbGUtMy5teXNob3BpZnkuY29tIiwic2hvcE5hbWUiOiJsaWx5ZGFsZS0zIiwiZW1haWwiOiJzdXBwb3J0QHB1cHBldHZlbmRvcnMuY29tIiwic2hvcE93bmVyIjoiUHVwcGV0IFZlbmRvcnMiLCJzaG9wUGhvbmUiOiI4MjI4MDgwMyIsInNob3BDb3VudHJ5IjoiU2luZ2Fwb3JlIiwic2hvcENpdHkiOiJTaW5nYXBvcmUiLCJzaG9wQ3VycmVuY3kiOiJTR0QiLCJzaG9wVGltZXpvbmUiOiJBbWVyaWNhL05ld19Zb3JrIiwiaWF0IjoxNjU0NTA4NDE0LCJleHAiOjE2NTQ1OTQ4MTR9.y7sXXNGgo32HphvaZnpv2u3vlm6BVzBQzFTDNKUTpAk",
"shopDomain": "lilydale-3.myshopify.com"
}Vendors
are your business partners, drop shippers, artists, and consignors you work with whom you wish to share your sales commissions with on PuppetVendors.
The Vendor resource allows you to manage their business information including but not limited to their name, commission type, commission rate, and business profile.
Users
are vendor staffs or owner who receives login credentials to the vendor portal.
Each vendor staff or owner account will only be able to view their own sale line items, orders, payouts, fulfillment, etc.
Reports
The reports API allows you to query vendor-specific order information to generate reports to your needs.
Payouts
represent the money owed to your business partners, drop shippers, artists, and consignors.
The payouts API allows you to query payouts information based on multiple parameters to meet your business requirements.
Fulfillments
indicate whether items whether physical or digital have been fulfilled by you - the business owner or your vendors.
The fulfillments API allows you to query fulfillment information based on multiple query parameters to meet your business requirements.
Commissions
represent the money you keep for your services or profit before sending the payouts to your business partners, drop shippers, artists, and consignors.
The commissions API allows you to query all commission information based on your vendors or skus.