> ## Documentation Index
> Fetch the complete documentation index at: https://dev.puppetvendors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PuppetVendors API

> Public REST API for the PuppetVendors multi-vendor marketplace platform

## Overview

The PuppetVendors API allows you to programmatically manage vendors, users, orders, products, payouts, fulfillments, commissions, and reports for your multi-vendor Shopify store.

**Base URL:** `https://api.puppetvendors.com`

## Resources

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Exchange your API key for a JWT token
  </Card>

  <Card title="Vendors" icon="store" href="/api-reference/endpoint/list-vendors">
    Manage vendor accounts, profiles, and addresses
  </Card>

  <Card title="Users" icon="users" href="/api-reference/endpoint/list-users">
    Create and manage vendor portal user accounts
  </Card>

  <Card title="Orders" icon="cart-shopping" href="/api-reference/endpoint/get-order">
    Retrieve orders and calculated line items
  </Card>

  <Card title="Products" icon="box" href="/api-reference/endpoint/list-products">
    List products with inventory and variant details
  </Card>

  <Card title="Payouts" icon="money-bill-wave" href="/api-reference/endpoint/list-payouts">
    Track vendor payout balances and payment status
  </Card>

  <Card title="Fulfillments" icon="truck" href="/api-reference/endpoint/list-fulfillments">
    Monitor and create order fulfillments
  </Card>

  <Card title="Commissions" icon="percent" href="/api-reference/endpoint/get-commissions-by-vendor">
    View commission rates by vendor or SKU
  </Card>

  <Card title="Reports" icon="chart-line" href="/api-reference/endpoint/get-reports">
    Pull vendor sales and earnings reports
  </Card>

  <Card title="Line Items" icon="pen-to-square" href="/api-reference/endpoint/update-line-items">
    Update report data, COGS, and trigger recalculations
  </Card>
</CardGroup>

## Rate Limits

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

## Authentication

All endpoints require a JWT token. Get started by exchanging your API key at [`POST /v1/authenticate`](/api-reference/authentication).

## Need Help?

Contact [support@puppetvendors.com](mailto:support@puppetvendors.com) for API access or questions.