Plan metadata

GET /plans returns static plan metadata: identifiers, plan classification, plan design amounts, brand assets, and required disclaimers. Group-specific pricing comes from the group’s quote. A broker key gets its two plans, diamond and value, in snake_case instead of this payload; see Plan details. The payload below is what an HR platform key gets.

The plan payload

curl https://www.getprescience.com/api/partner/v1/plans \
  -H "Authorization: Bearer $PRESCIENCE_API_KEY"

Response (200)

{
  "plans": [
    {
      "id": "diamond",
      "name": "Prescience Diamond",
      "carrierName": "Prescience",
      "planType": "self_funded_level_funded",
      "deductibleIndividualCents": 0,
      "deductibleFamilyCents": 0,
      "oopMaxIndividualCents": 100000,
      "oopMaxFamilyCents": 250000,
      "hsaEligible": true,
      "employerContribution": { "minPct": 50, "maxPct": 100 },
      "assets": {
        "logoUrl": "https://www.getprescience.com/img/prescience-wordmark.svg",
        "markUrl": "https://www.getprescience.com/img/prescience-mark.png"
      },
      "disclaimers": [
        "Final plan documents govern. Benefit details are confirmed during onboarding."
      ]
    }
  ]
}

The payload is static per API version, so it is safe to cache for a day. Use the assets URLs directly or mirror them in your CDN.

Combining plan and quote data

Use the plan payload for static fields and the group’s quote for employer-specific amounts:

Data	Source
Logo and name	`plan.assets.markUrl`, `plan.name`
Plan classification	`plan.planType`, `plan.hsaEligible`
Monthly amount	`quote.monthly.totalCents`, `quote.monthly.pepmCents`
Employer contribution	`plan.employerContribution`: the employer covers between `minPct` and `maxPct` of each premium, chosen at setup, and employees pay the rest through payroll
Market-benchmark comparison	`quote.comparison.*`
Deductible and out-of-pocket maximums	The group’s own: `quote.benefits.`. `plan.` holds only Diamond’s typical design
Disclaimers and quote assumptions	`plan.disclaimers`, `quote.assumptions`

Use approved display names such as Prescience Diamond or Prescience-managed health benefits in customer-facing surfaces. Treat planType as backend classification for eligibility, quoting, and regulated workflows, not as marketing copy. carrierName is a display string, not a legal classification. See Compliance.

Wiring selection

When the employer accepts a quote, create an enrollment with the groupId, the quoteId, and the admin’s identity for the signatory.

Quotes expire at expiresAt (configuration-driven; 30 days by default). If a stale quote is selected past expiry, catch the 410 quote_expired from POST /enrollments, create a new quote, and retry with the new quoteId. A new a fresh pricing run may change available plans or rates, so always use the newly returned values.

Get Started

Guides

Brokers

Resources

The plan payload

Combining plan and quote data

Wiring selection

​The plan payload

​Combining plan and quote data

​Wiring selection

The plan payload

Combining plan and quote data

Wiring selection