Partner API v1.1
Additive release; no breaking changes. Existing integrations continue to work unchanged.Onboarding pathwaysPOST /groups/{groupId}/enrollmentsacceptsonboardingMode: "hosted" | "embedded"(defaulthosted). On the hosted pathway, Prescience provisions the enrollment signatory as an employer portal admin and runs onboarding, KYB, banking, and plan setup in the Prescience employer portal.- Enrollment responses now carry
onboardingModeand, when the signatory was provisioned, anemployerPortalobject (provisioned,signinUrl,inviteSuppressed). - Embedded onboarding schemas are available for integrations that use that pathway.
- Test mode never sends outbound email. Portal accounts are still provisioned and the response reports
employerPortal.inviteSuppressed: true.
- Quote responses gain an additive
pricingobject (source,updatedAt) naming the rate-card layer that priced the quote. - Quote expiry and the underwriting in-review employee threshold are now rate-card driven; the defaults are unchanged (30 days, 200 employees).
Partner API v1
First public release of the Prescience Partner API.Core flowPOST /groups,GET /groups,GET/PATCH /groups/{groupId}: employer groups with lifecycle (created→census_received→quoted→enrolled→active)PUT/GET /groups/{groupId}/census: full-census replace with per-row errors; upsert by email/externalId; up to 10,000 membersPOST /groups/{groupId}/quotes: synchronous, deterministic quotes with tier breakdowns and prior-cost comparison;in_reviewflow for groups over 200 employeesPOST /groups/{groupId}/enrollments: provisioning into the onboarding pipeline (sandbox→prodstate machine)
GET /plans: static plan metadata, plan facts, assets, and disclaimersGET /groups/{groupId}/account: aggregate, de-identified employer account data covering funding, premium breakdown, spend categories with k-anonymity suppression, and savingsGET /groups/{groupId}/members: enrollment roster with invitation status and COBRA
POST /groups/{groupId}/members,PATCH /groups/{groupId}/members/{memberId}: new hires, updates, terminations with COBRA handling; post-enrollment changes propagate to the live census
- Bearer-key auth with
psk_test_/psk_live_modes and full mode isolation - Signed webhooks (standard-webhooks scheme):
ping,quote.finalized,enrollment.created,group.state_changed,census.processed Idempotency-Keysupport on all POST/PUT endpoints (24h replay)- Rate limits: 120 req/min, census writes 20/min, quotes 60/hour, with
Retry-After