Vendor API — Peptide.best

Overview

The Peptide.best Vendor API lets approved vendors integrate inventory, order fulfillment, COAs, and analytics directly into their own systems. It's a REST API speaking JSON over HTTPS, available to every active vendor at no additional cost.

Base URL: https://api.peptide.best/v1
Auth: Bearer token in Authorization header
Format: JSON request and response bodies
Versioning: URL-versioned (/v1, /v2). Breaking changes get a new version; non-breaking changes append fields without notice.

Authentication

Generate an API key from Vendor Portal → Settings → API. Pass it as a bearer token:

curl -X GET https://api.peptide.best/v1/products \
  -H "Authorization: Bearer pk_live_XXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json"

Keys are scoped to the issuing vendor and expire after 365 days of inactivity. Revoke compromised keys immediately from the portal. Use restricted keys (read-only or limited-scope) where possible.

Endpoints

Products

GET /v1/products — list your products
POST /v1/products — create a new product listing (subject to verification)
GET /v1/products/{id} — get product details
PATCH /v1/products/{id} — update price, inventory, description
DELETE /v1/products/{id} — archive listing
POST /v1/products/{id}/coa — upload new batch COA (PDF + structured fields)

Inventory

GET /v1/inventory — list stock levels
PATCH /v1/inventory/{sku} — update available quantity
POST /v1/inventory/bulk — batch update via CSV upload

Orders

GET /v1/orders — list orders, filterable by status/date
GET /v1/orders/{id} — full order detail
POST /v1/orders/{id}/fulfill — mark fulfilled, attach tracking number
POST /v1/orders/{id}/cancel — cancel (only if not yet shipped)

Payouts

GET /v1/payouts — list payouts
GET /v1/payouts/{id} — payout detail with line items

Reviews

GET /v1/reviews — list reviews of your products
POST /v1/reviews/{id}/reply — reply publicly (one reply per review)
POST /v1/reviews/{id}/flag — flag for moderation

Analytics

GET /v1/analytics/sales — daily/weekly/monthly
GET /v1/analytics/conversion — funnel metrics
GET /v1/analytics/ads — sponsored campaign performance

Webhooks

Subscribe to events for real-time syncing:

order.created, order.paid, order.fulfilled, order.refunded
review.created, review.flagged, review.removed
payout.processed
inventory.low, inventory.outOfStock

Configure webhook URLs at Vendor Portal → Settings → Webhooks. Webhooks are signed with HMAC-SHA256; verify the signature header before processing.

Sample: fulfill an order

curl -X POST https://api.peptide.best/v1/orders/ord_abc123/fulfill \
  -H "Authorization: Bearer pk_live_XXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "carrier": "UPS",
    "tracking_number": "1Z999AA10123456784",
    "shipped_at": "2026-05-20T14:30:00Z",
    "cold_chain": true
  }'

Rate limits

Default: 1,000 requests per minute per API key, 50,000 per day. Higher limits available on request for high-volume integrations. Rate limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) included on every response. Exceeded limits return 429 Too Many Requests with Retry-After.

Errors

Standard HTTP status codes. Errors return JSON with shape:

{
  "error": {
    "code": "validation_error",
    "message": "tracking_number is required",
    "field": "tracking_number",
    "request_id": "req_1234567890"
  }
}

Include request_id in support tickets.

SDKs

Official SDKs: Node.js (npm install @peptide-best/sdk), Python (pip install peptide-best), PHP, Ruby. Source on GitHub.

Sandbox

Use pk_test_-prefixed keys against https://api.peptide.best/v1 with header X-Sandbox-Mode: true. No real orders are created; test data is reset weekly.

Support

API questions: developers@peptide.best. Status page: status.peptide.best. Changelog: api.peptide.best/changelog.

Peptide.best API