Platform · Shipped
Paid agent-commerce data API (HO-218)
The metered /api/v1/* data API over the commerce till: pa_ API keys (sha256-hashed, minted on Developer-plan purchase, race-safe across webhook + success page), a per-call priced usage ledger (commerce.api_usage — volume steps + plan policy: 25k included lookup-class calls on Developer, no per-call metering on Enterprise), 402-with-Checkout-link inline agent purchase, and a nightly cents-denominated Stripe Billing Meter push. Endpoints: minimum-wage lookup/dataset, roster compliance, OEWS benchmark, JobFrame resolve/match/bulk-map; OpenAPI at /api/v1/openapi.json. Contract + posted prices owned by pa-site (PAID-API-CONTRACT.md / api-pricing.ts, vendored).
- Cluster
- Platform
- Type
- service
- Status
- Shipped
- Used by
- peopleanalyst-site, people-analytics-toolbox
Maturity evidence
- Functioning
- 16 hermetic tests (volume-step pricing, plan policy, key extraction, Stripe-push grouping); end-to-end smoke 2026-06-29 (keyed roster billed 10¢; 402 + checkoutUrl over free ceiling).
- Valuable
- The agent-commerce till for data SKUs (pa-site PA-804/PA-874 gate); revenue pending first metered consumer + Stripe meter go-live.
- Understood
- pa-site docs/api/PAID-API-CONTRACT.md + session reports 2026-06-29 HO-218 / 2026-07-03 PAT-F5-D3; go-live runbook in src/lib/paid-api/stripe-push.ts header.
- Integrated
- Rides the commerce till (products/webhook/entitlements); prices vendored from pa-site api-pricing.ts; /developers on pa-site markets it; nightly push cron in vercel.ts.
How to use it
- REST
- GET/POST /api/v1/* (Authorization: Bearer pa_…)
- Data
- GET /api/v1/openapi.json
Other Platform capabilities
- Comp audit self-serve — CSV intake, free validate, commerce-gated watermarked run (HO-155)
- Gift pass — gifted ownership on the entitlement store (magic-link claim)
- JobFrame canonical Job Family × Focus × Level taxonomy + classifier
- SMB pay-system wizard — chocolate/vanilla over the pay-system catalog
- Support channel — portfolio-wide /support form → ticket store → operator email
- Ask-your-data — generalizable NL→rank→tier→cite spoke (HO-378)
- Diagnostic acquisition — next-best-ask over a live hypothesis set
- Executive-Priorities Elicitation Instruments (static catalog)
Capability detail sourced from the People Analytics Toolbox capability feed (source of truth), snapshot retrieved 2026-07-23.