# PuppetVendors API

## Docs

- [Authentication](https://dev.puppetvendors.com/api-reference/authentication.md): Authenticate with the PuppetVendors API
- [Bulk Upload SKU Commissions](https://dev.puppetvendors.com/api-reference/endpoint/bulk-upload-commissions.md): Upsert SKU-level commissions and cost of goods in bulk
- [Create Fulfillment](https://dev.puppetvendors.com/api-reference/endpoint/create-fulfillment.md): Fulfill line items with tracking information
- [Create User](https://dev.puppetvendors.com/api-reference/endpoint/create-user.md): Create a vendor portal user account
- [Create Vendor](https://dev.puppetvendors.com/api-reference/endpoint/create-vendor.md): Register a new vendor in your shop
- [Delete User](https://dev.puppetvendors.com/api-reference/endpoint/delete-user.md): Permanently delete a vendor portal user account
- [Delete Vendor](https://dev.puppetvendors.com/api-reference/endpoint/delete-vendor.md): Soft-delete a vendor from your shop
- [Get Commissions by SKU](https://dev.puppetvendors.com/api-reference/endpoint/get-commissions-by-sku.md): List commission rates and cost of goods per SKU
- [Get Commissions by Vendor](https://dev.puppetvendors.com/api-reference/endpoint/get-commissions-by-vendor.md): List commission rates for all vendors
- [Get Order](https://dev.puppetvendors.com/api-reference/endpoint/get-order.md): Retrieve an order or its calculated line items
- [Get Vendor Reports](https://dev.puppetvendors.com/api-reference/endpoint/get-reports.md): Retrieve calculated line item reports for a vendor
- [Get Vendor Profile Fields](https://dev.puppetvendors.com/api-reference/endpoint/get-shop-profile.md): List the custom profile fields available for vendors
- [Get User](https://dev.puppetvendors.com/api-reference/endpoint/get-user.md): Retrieve a single vendor portal user
- [Get Vendor](https://dev.puppetvendors.com/api-reference/endpoint/get-vendor.md): Retrieve a single vendor by ID
- [Get Vendor Address](https://dev.puppetvendors.com/api-reference/endpoint/get-vendor-address.md): Retrieve a vendor's business address
- [Get Vendor Profile](https://dev.puppetvendors.com/api-reference/endpoint/get-vendor-profile.md): Retrieve a vendor's custom profile fields
- [List Fulfillments](https://dev.puppetvendors.com/api-reference/endpoint/list-fulfillments.md): Retrieve fulfillment data for line items
- [List Payouts](https://dev.puppetvendors.com/api-reference/endpoint/list-payouts.md): Retrieve payout line items with filtering
- [List Products](https://dev.puppetvendors.com/api-reference/endpoint/list-products.md): Retrieve products with pagination
- [List Users](https://dev.puppetvendors.com/api-reference/endpoint/list-users.md): Retrieve all vendor portal users
- [List Vendors](https://dev.puppetvendors.com/api-reference/endpoint/list-vendors.md): Retrieve all vendors registered in your shop
- [Update Line Items](https://dev.puppetvendors.com/api-reference/endpoint/update-line-items.md): Update report data and cost of goods for line items
- [Update User](https://dev.puppetvendors.com/api-reference/endpoint/update-user.md): Update a vendor portal user's email or password
- [Update Vendor](https://dev.puppetvendors.com/api-reference/endpoint/update-vendor.md): Modify a vendor's name or commission settings
- [Update Vendor Address](https://dev.puppetvendors.com/api-reference/endpoint/update-vendor-address.md): Set or update a vendor's business address
- [Update Vendor Profile](https://dev.puppetvendors.com/api-reference/endpoint/update-vendor-profile.md): Update a vendor's custom profile fields
- [Authenticate](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-authenticate.md): Exchange your vendor API key for a JWT token
- [Create Discount](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-create-discount.md): Create a new discount code as a vendor
- [Create Fulfillment](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-create-fulfillment.md): Fulfill line items with tracking information as a vendor
- [Create Product](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-create-product.md): Create a new product as a vendor with Shopify sync
- [Create User](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-create-user.md): Create a new user account for the vendor
- [Delete Discount](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-delete-discount.md): Delete a vendor discount code
- [Delete User](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-delete-user.md): Delete a user account belonging to the vendor
- [Get Order](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-order.md): Retrieve a single order with vendor-scoped line items
- [Get Payout](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-payout.md): Retrieve a single payout transaction with item details
- [PayPal](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-paypal.md): Retrieve the vendor's PayPal integration
- [Shippo](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-shippo.md): Retrieve the vendor's Shippo shipping integration
- [ShipStation](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-shipstation.md): Retrieve the vendor's ShipStation integration
- [Stripe](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-get-stripe.md): Retrieve the vendor's Stripe Connect integration status
- [List Customers](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-customers.md): Retrieve a paginated customer directory from vendor order data
- [List Discounts](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-discounts.md): Retrieve vendor-scoped discount codes
- [List Fulfillments](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-fulfillments.md): Retrieve vendor-scoped fulfillment items with cursor-based pagination
- [List Orders](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-orders.md): Retrieve vendor-scoped orders with cursor-based pagination
- [List Payouts](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-payouts.md): Retrieve vendor-scoped payout transactions with cursor-based pagination
- [List Products](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-products.md): Retrieve vendor-scoped products with cursor-based pagination
- [List Users](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-list-users.md): Retrieve a paginated list of users belonging to the vendor
- [Refresh Token](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-refresh-token.md): Exchange a valid vendor token for a new one with extended expiry
- [Update Discount](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-discount.md): Update an existing vendor discount code
- [Update Fulfillment](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-fulfillment.md): Update fulfillment tracking information as a vendor
- [PayPal](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-paypal.md): Configure or update the vendor's PayPal integration
- [Shippo](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-shippo.md): Configure or update the vendor's Shippo integration
- [ShipStation](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-shipstation.md): Configure or update the vendor's ShipStation integration
- [Update User](https://dev.puppetvendors.com/api-reference/v2/endpoint/vendor-update-user.md): Update an existing user account belonging to the vendor
- [API Keys & Scopes](https://dev.puppetvendors.com/api-reference/v2/vendor/api-keys-scopes.md): Create vendor API keys and understand permission scopes
- [Vendor Authentication](https://dev.puppetvendors.com/api-reference/v2/vendor/authentication.md): Authenticate with the PuppetVendors V2 API using a vendor API key
- [Add Order Timeline Note](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/add-order-timeline.md): Add a note to an order's timeline
- [AI Product Description](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/ai-description.md): Generate a product description using AI based on product details
- [Bulk Create Fulfillment Events](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/bulk-create-fulfillment-events.md): Create multiple fulfillment events in a single request (max 100)
- [Create Fulfillment Event](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/create-fulfillment-event.md): Create a tracking event for a line item's fulfillment
- [Create Shipping Dimension](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/create-shipping-dimension.md): Create a new shipping dimension preset
- [Create Team Member](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/create-team-member.md): Invite a new team member to the vendor account
- [Add Warehouse](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/create-warehouse.md): Add a new warehouse / location to the vendor
- [Delete PayPal Configuration](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-paypal.md): Remove the vendor's PayPal email
- [Delete Product](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-product.md): Delete a product from Shopify and soft-delete locally
- [Delete Shipping Dimension](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-shipping-dimension.md): Delete a shipping dimension preset
- [Delete Shippo Configuration](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-shippo.md): Remove the vendor's Shippo API key
- [Delete ShipStation Configuration](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-shipstation.md): Remove the vendor's ShipStation API credentials
- [Disconnect Stripe Account](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-stripe.md): Disconnect and delete the vendor's Stripe Connect account
- [Delete Team Member](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-team-member.md): Remove a team member from the vendor account
- [Delete Warehouse](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/delete-warehouse.md): Remove a warehouse at the given index
- [Duplicate Product](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/duplicate-product.md): Clone an existing product into a new draft
- [Get Fulfillment Counts](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/fulfillment-counts.md): Get a breakdown of fulfillment counts by status
- [Get Fulfillment Stats](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/fulfillment-stats.md): Get headline fulfillment performance statistics
- [Generate Barcode](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-barcode.md): Generate a unique barcode for a product variant
- [Generate Customer Invoice PDF](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-customer-invoice-doc.md): Generate a customer-facing invoice PDF (S3 URL, 48h expiry)
- [Generate Generic Label](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-generic-label.md): Generate a generic shipping label without purchasing a carrier rate
- [Generate Grouped Invoice by Vendor](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-grouped-invoice.md): Consolidated invoice PDF for all orders from specific vendors within a date range
- [Generate Vendor Invoice PDF](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-invoice.md): Generate a single-order vendor invoice PDF (S3 URL, 48h expiry)
- [Generate Packing Slip PDF](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-packing-slip.md): Generate a single-order packing slip PDF (S3 URL, 48h expiry)
- [Generate Shipping Label PDF](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/generate-shipping-label.md): Generate a shipping label PDF for order fulfillment (S3 URL, 48h expiry)
- [Get Account Settings](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-account-settings.md): Retrieve the authenticated user's account information
- [Get My Vendor Address](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-my-address.md): Retrieve the authenticated vendor's own address
- [Get My Vendor Profile](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-my-profile.md): Retrieve the authenticated vendor's own profile
- [Get Order Timeline](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-order-timeline.md): Get the timeline of events and notes for a specific order
- [Get Product](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-product.md): Retrieve a single product with full details including variants, images, and metafields
- [Get Profile Settings](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-profile-settings.md): Retrieve the vendor's storefront profile grouped by portal tabs
- [Get Shipping Rates](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-shipping-rates.md): Retrieve the vendor's shipping rate configuration
- [Get Shipping Rates for Order](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-shipping-rates-op.md): Fetch real-time shipping rates for an order's line items
- [Get User](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-user.md): Retrieve a single vendor portal user by ID
- [Get Warehouse](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/get-warehouse.md): Retrieve a single warehouse by its locationId
- [List Fulfillment Events](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/list-fulfillment-events.md): List all tracking events for a line item's fulfillment
- [List Available Integrations](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/list-integrations.md): Return the list of integration providers supported by the vendor portal
- [List Shipping Dimensions](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/list-shipping-dimensions.md): Retrieve saved shipping dimension presets
- [List Team Members](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/list-team-members.md): Retrieve team members for the vendor account
- [List Warehouses](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/list-warehouses.md): Retrieve all warehouses (locations) for the authenticated vendor
- [Get Order Counts](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/order-counts.md): Get a count of orders grouped by fulfillment status
- [Get Payout Batch Detail](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/payout-batch-detail.md): Get detailed breakdown of a specific payout batch
- [Payout Summary](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/payout-summary.md): Get a high-level summary of payout totals and the next scheduled payout
- [List Payout Transactions](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/payout-transactions.md): List payout transactions with cursor pagination and filters
- [List Pending Payouts](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/pending-payouts.md): List line items that are pending payout with offset pagination
- [Forgot Password](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-forgot-password.md): Send a password reset link to a vendor's email
- [List Vendors for User](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-list-vendors.md): Get all vendor accounts linked to the authenticated user
- [Vendor Portal Login](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-login.md): Authenticate a vendor user with email and password; returns a JWT
- [Vendor Portal Logout](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-logout.md): Invalidate the current vendor session token
- [Refresh Vendor Token](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-refresh-token.md): Exchange a valid vendor token for a new one with extended expiry
- [Vendor Portal Signup](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/portal-signup.md): Create a new vendor portal signup request (pending merchant approval)
- [Get Product Counts](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/product-counts.md): Get a breakdown of how many products you have in each status
- [Purchase Shipping Label](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/purchase-shipping-label.md): Purchase a shipping label for an order using a selected rate
- [Initiate Stripe Connect](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/stripe-connect.md): Start the Stripe Connect onboarding process for the vendor
- [Update Account Settings](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-account-settings.md): Update the authenticated user's account information or password
- [Update Fulfillment Event](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-fulfillment-event.md): Update an existing fulfillment event
- [Update My Vendor Address](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-my-address.md): Update the authenticated vendor's own address
- [Update My Vendor Profile](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-my-profile.md): Update the authenticated vendor's own profile
- [Update Product](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-product.md): Full product update via Shopify productSet mutation
- [Update Product Inventory](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-product-inventory.md): Inventory-only update without touching product/variant data
- [Update Product Status](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-product-status.md): Change a product's status to ACTIVE or DRAFT
- [Update Profile Settings](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-profile-settings.md): Update the vendor's storefront profile using strict tab-based sections
- [Update Shipping Dimension](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-shipping-dimension.md): Update an existing shipping dimension preset
- [Update Shipping Rates](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-shipping-rates.md): Set or update the vendor's shipping rate configuration
- [Update Team Member](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-team-member.md): Update an existing team member's details or permissions
- [Update Warehouse](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/update-warehouse.md): Update an existing warehouse at the given index
- [Upload Product Media](https://dev.puppetvendors.com/api-reference/v2/vendor/endpoint/upload-product-media.md): Upload media to Shopify staging for later use in product creation
- [Error Handling](https://dev.puppetvendors.com/api-reference/v2/vendor/errors.md): Standard error responses in the V2 Vendor API
- [V2 Vendor API Introduction](https://dev.puppetvendors.com/api-reference/v2/vendor/introduction.md): Overview of the PuppetVendors V2 Vendor API (Alpha)
- [Pagination](https://dev.puppetvendors.com/api-reference/v2/vendor/pagination.md): Cursor-based pagination in the V2 Vendor API
- [Quick Start](https://dev.puppetvendors.com/api-reference/v2/vendor/quickstart.md): Get up and running with the PuppetVendors Vendor API in 5 minutes
- [PuppetVendors API](https://dev.puppetvendors.com/index.md): Public REST API for the PuppetVendors multi-vendor marketplace platform

## OpenAPI Specs

- [openapi](https://dev.puppetvendors.com/openapi.yaml)

## Optional

- [PuppetVendors](https://puppetvendors.com)