Pax8

Pax8 — PHATT TECH

PHATT TECH's distributor portal for Microsoft 365 and other cloud services.

Prefer: CLI (pax8-cli)

cd /root/.openclaw/workspace/skills/pax8-cli
npx tsx scripts/pax8.ts <command> <subcommand> [options]

Pipe for JSON (agent mode, auto-detected via TTY):

npx tsx scripts/pax8.ts companies list --all | jq '.[].name'

CLI Commands

# Companies
pax8 companies list [--size 25] [--page 0] [--all] [--search term]
pax8 companies get <id>
pax8 companies create --name "Acme" --email admin@acme.com [--phone] [--street] [--city] [--state OH] [--zip]
pax8 companies update <id> [--name] [--email] ...

# Products
pax8 products list [--all] [--vendor Microsoft] [--search "Teams"]
pax8 products get <id>
pax8 products pricing <id>
pax8 products provision-details <id>      # Required before first NCE order
pax8 products dependencies <id>           # Shows commitmentTermId for NCE orders

# Subscriptions (alias: subs)
pax8 subs list [--company <id>] [--all] [--status Active]
pax8 subs get <id>
pax8 subs update <id> [--quantity 5] [--auto-renew true]
pax8 subs cancel <id>
pax8 subs history <id>

# Orders
pax8 orders list [--company <id>] [--all]
pax8 orders get <id>
pax8 orders create --product <id> --quantity 5 [--company <id>] [--mock]
pax8 orders create-nce \
  --company <companyId> \
  --product <productId> \
  --quantity 5 \
  --commitment-term <uuid> \
  --provision '{"key":"TenantId","values":["<tenantId>"]}' \
  --provision '{"key":"TenantDomain","values":["tenant.onmicrosoft.com"]}' \
  [--mock]

# Contacts
pax8 contacts list <companyId> [--all]
pax8 contacts get <companyId> <contactId>
pax8 contacts create <companyId> --first John --last Doe --email john@co.com [--type Admin]
pax8 contacts update <companyId> <contactId> [--first] [--email] ...
pax8 contacts delete <companyId> <contactId>

# Invoices
pax8 invoices list [--company <id>] [--all] [--status Issued]
pax8 invoices get <id>
pax8 invoices items <id>
pax8 invoices draft-items [--company <id>]

NCE Workflow:

1. pax8 products dependencies <productId> → find commitmentTermId
2. pax8 products provision-details <productId> → find required provision keys
3. pax8 orders create-nce ... --mock → verify, then run without --mock

CLI Examples

# List all companies
npx tsx scripts/pax8.ts companies list --all

# List active subs for EMP
npx tsx scripts/pax8.ts subs list --company de9e63c9-9731-4edf-9baf-44877fb0fc59

# Get product name from subscription productId
npx tsx scripts/pax8.ts products get <productId>

# Check invoices
npx tsx scripts/pax8.ts invoices list --all

Raw API (when CLI isn't enough)

Auth

PAX8_TOKEN=$(curl -s -X POST "https://api.pax8.com/v1/token" \
  -H "content-type: application/json" \
  -d '{
    "client_id": "7bzY2IN0tfZ3jq1vmGMfvMA7qaVATH9E",
    "client_secret": "Mo2wgcyQvjXxfSsi7qmKV5hjvyv16tVrid4EuGjmrR1vjGx7IjniGXVXjRTkkXq2",
    "audience": "https://api.pax8.com",
    "grant_type": "client_credentials"
  }' | python3 -c "import sys,json; print(json.load(sys.stdin)['access_token'])")

Use Authorization: Bearer $PAX8_TOKEN. Tokens expire ~24h.

Quick Reference

# List companies
curl -s -H "Authorization: Bearer $PAX8_TOKEN" \
  "https://api.pax8.com/v1/companies?page=0&size=100"

# List active subscriptions
curl -s -H "Authorization: Bearer $PAX8_TOKEN" \
  "https://api.pax8.com/v1/subscriptions?page=0&size=100&status=Active"

# Subs for specific company
curl -s -H "Authorization: Bearer $PAX8_TOKEN" \
  "https://api.pax8.com/v1/subscriptions?page=0&size=100&companyId=COMPANY_ID"

# Product name lookup
curl -s -H "Authorization: Bearer $PAX8_TOKEN" \
  "https://api.pax8.com/v1/products/PRODUCT_ID"

Known Company IDs

Agent Guidance

• Prefer CLI for routine ops — handles pagination and formatting automatically
• All raw API list endpoints REQUIRE ?page=0&size=N — without them returns empty
• Product names are NOT on subscription objects — do a products get <productId> lookup
• NCE: commitmentTermId on the lineItem, provisioningDetails at order level, values always an array
• Use --mock / ?isMock=true for dry-run order testing
• NEVER test PUT on production subscriptions — mid-term NCE changes can trigger billing events
• EMP subs locked until Oct 6, 2026 renewal — do not touch seat counts
• 14 active customers as of Feb 2026