OK Capsule API
OK Capsule provides custom supplement fulfillment services. Our API enables you to programmatically create orders, manage consumers, and track shipments.
What We Do
OK Capsule manufactures and ships personalized supplement packs. Each pack contains individual pouches with supplements tailored to your customer's needs. We handle:
- Manufacturing - Packaging supplements into daily pouches
- Labeling - Custom branding with your product line
- Fulfillment - Shipping directly to your customers
- Tracking - Real-time shipment status
How It Works
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ Create │ ──▶ │ Order is │ ──▶ │ Order is │ ──▶ │ Customer │
│ Order │ │ Produced │ │ Shipped │ │ Receives │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
- You create an order via API with consumer info and supplement selection
- OK Capsule produces the custom supplement pouches
- Order ships with tracking information sent back via API
- Customer receives their personalized supplements
Core Concepts
| Term | Route | Description |
|---|---|---|
| Client | /v2/clients | Your organization (business partner submitting orders) |
| Consumer | /v2/consumers | Your end customer who receives supplements |
| Product | /v2/products | A client-specific instance of an OKC Product with custom branding |
| Order | /v2/orders | A request to fulfill supplements for a consumer |
| Order Line | — | A set of pouches within an order (e.g., 30-day supply) |
| Pouch | — | An individual daily packet of supplements |
| Fulfillment | /v2/fulfillments | Shipping, tracking, and delivery information for an order |
| Assembly | /v2/assemblies | A client's predefined bundle of products (commonly called a "pack") |
| Product Line | /v2/product-lines | A client's marketing brand (appears on packaging) |
| OKC Product | — | A supplement in the OK Capsule master catalog (what OKC purchases from vendors) |
| User | /v2/users | An authorized person who accesses the API or portal |
| Contact | /v2/contacts | A person associated with a client, managed for communication purposes |
Environments
| Environment | Base URL | Purpose |
|---|---|---|
| Production | https://na1-prod.okcapsule.app | Live orders |
| Stage | https://na1-stage.okcapsule.app | Testing |
Environment Separation
Users, products, and orders are environment-specific. Stage data does not affect production.
Quick Links
- Getting Started - Authentication and first API call
- Create Orders - Order creation patterns
- Interactive API Docs - Full endpoint reference