Getting Started
What Augur is, how to install the SDK, and make your first API call.
Getting Started
Augur is a microservices platform by SimpleApps that wraps Prophet 21 ERP and extends it with e-commerce, payments, shipping, search, and AI capabilities for industrial distribution.
Instead of building directly against P21's database or Epicor APIs, you call Augur's REST services. Each service runs at https://{service}.augur-api.com and exposes a clean JSON API behind Cloudflare's CDN.
Who is it for?
| Audience | Use Case |
|---|---|
| Internal devs | Build SimpleApps client sites and mobile apps |
| Third-party devs | Integrate P21 data into custom applications |
| AI agents | Automate workflows via MCP server or SDK |
| Non-technical users | Use Claude Code or similar AI tools with Augur skills |
Install the SDK
pnpm add @simpleapps-com/augur-apiAlso available for Python and PHP.
Set your credentials
You need a site ID and JWT token from SimpleApps. Contact [email protected] to get started.
export AUGUR_SITE_ID="your-site-id"
export AUGUR_TOKEN="your-jwt-token"Or create ~/.simpleapps/augur-api.json:
{
"siteId": "your-site-id",
"jwt": "your-jwt-token"
}See API Overview for full credential resolution order and multi-site format.
Make your first call
import { AugurAPI } from '@simpleapps-com/augur-api';
const api = new AugurAPI({
siteId: process.env.AUGUR_SITE_ID,
bearerToken: process.env.AUGUR_TOKEN,
});
const items = await api.items.invMast.list({ limit: 10 });
console.log(items.data);
const customers = await api.customers.customer.list({ limit: 5 });
console.log(customers.data);Explore services
Every service is a property on the api object:
api.items // Product catalog, attributes, variants
api.customers // Contacts, addresses, invoices
api.orders // Order management, quotes
api.pricing // Price engine, job pricing
api.commerce // Carts, checkout
api.payments // Payment processing
api.shipping // Rate shopping
api.openSearch // Full-text product search
// ... see service directory for full listNext steps
- API Overview — Auth, response format, pagination, caching
- Services — All microservices with links to auto-generated docs
- Packages — React hooks, UI components, server utils
- AI Agents — Use Augur with Claude Code or MCP
- Build a Next.js App — Storefronts, dashboards, and portals