> ## Documentation Index > Fetch the complete documentation index at: https://getprescience.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get the employer account > Aggregate employer account data: funding, premium-equivalent totals, spend by category, and savings. Account data is aggregate and de-identified by design. Returns `404 not_found` until the group is enrolled. ## OpenAPI ````yaml /api-reference/openapi.json get /groups/{groupId}/account openapi: 3.1.0 info: title: Prescience Partner API version: 1.1.0 description: >- Create employer groups, submit census records, generate indicative quotes, create enrollments, and read aggregate account data. Money is always integer cents. Dates are `YYYY-MM-DD`; timestamps are ISO 8601 UTC. Quotes are indicative pending underwriting confirmation. A BAA and data processing agreement are executed before live mode is enabled. contact: name: Prescience partner engineering email: partners@getprescience.com servers: - url: https://www.getprescience.com/api/partner/v1 description: >- Production. Test and live traffic share this host; mode comes from your API key. security: - bearerAuth: [] tags: - name: Health description: Connectivity and key checks. - name: Plans description: Static plan metadata. - name: Groups description: 'Employer groups: the root resource of every integration.' - name: Census description: Pre-enrollment census intake and ongoing member sync. - name: Quotes description: Deterministic, synchronous quotes. Indicative pending underwriting. - name: Enrollments description: Plan selection and employer provisioning. - name: Account description: Aggregate, de-identified employer account data. - name: Webhooks description: Signed event delivery (standard-webhooks scheme). paths: /groups/{groupId}/account: get: tags: - Account summary: Get the employer account description: >- Aggregate employer account data: funding, premium-equivalent totals, spend by category, and savings. Account data is aggregate and de-identified by design. Returns `404 not_found` until the group is enrolled. operationId: getAccount parameters: - $ref: '#/components/parameters/GroupId' responses: '200': description: Aggregate employer benefits data. content: application/json: schema: $ref: '#/components/schemas/Account' example: groupId: grp_8c2f41d09a3e asOf: '2026-11-03T16:20:00Z' company: displayName: Acme Inc state: prod startDate: '2026-09-01' renewalDate: '2027-09-01' plan: name: Prescience Diamond deductibleIndividualCents: 150000 deductibleFamilyCents: 300000 oopMaxIndividualCents: 705000 oopMaxFamilyCents: 1410000 employeePremiumCents: 0 population: coveredLives: 19 enrolledEmployees: 12 dependents: 7 funding: fundBalanceCents: 990144 monthlyFundingCents: 660096 upcomingPulls: - date: '2026-12-01' amountCents: 660096 status: scheduled recentPulls: - date: '2026-11-01' amountCents: 660096 status: completed - date: '2026-10-01' amountCents: 660096 status: completed premiums: monthlyPremiumEquivalentCents: 660096 pepmCents: 55008 employeeContributionCents: 0 breakdown: - label: Claims paid cents: 408540 - label: HSA funding cents: 132019 - label: Risk protection & reserves cents: 119537 - label: Admin fees cents: 0 spend: mtdCents: 23418 ytdCents: 802340 categories: - category: Prescriptions cents: 240702 pct: 30 - category: Specialty care cents: 192562 pct: 24 - category: Primary care cents: 168491 pct: 21 - category: Imaging & labs cents: 120351 pct: 15 - category: Behavioral health cents: 80234 pct: 10 suppressed: false savings: baselineAnnualCents: 11520000 savingsYtdCents: 599808 '401': $ref: '#/components/responses/Unauthorized' '404': description: Group not found, or not enrolled yet. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: not_found message: >- Group grp_8c2f41d09a3e is not enrolled. The account becomes available after enrollment. '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/ServerError' components: parameters: GroupId: name: groupId in: path required: true description: Group ID, e.g. `grp_8c2f41d09a3e`. schema: type: string pattern: ^grp_[0-9a-f]{12}$ example: grp_8c2f41d09a3e schemas: Account: type: object description: >- Aggregate and de-identified by design: never named claims, diagnoses, or any individual health data. Categories that could be traced to small member counts are suppressed (k-anonymity). required: - groupId - asOf - company - plan - population - funding - premiums - spend - savings properties: groupId: type: string example: grp_8c2f41d09a3e asOf: type: string format: date-time company: type: object properties: displayName: type: string example: Acme Inc state: type: string enum: - sandbox - prod startDate: type: string format: date renewalDate: type: string format: date plan: type: object properties: name: type: string example: Prescience Diamond deductibleIndividualCents: type: integer example: 150000 deductibleFamilyCents: type: integer example: 300000 oopMaxIndividualCents: type: integer example: 705000 oopMaxFamilyCents: type: integer example: 1410000 employeePremiumCents: type: integer const: 0 population: type: object properties: coveredLives: type: integer enrolledEmployees: type: integer dependents: type: integer funding: type: object properties: fundBalanceCents: type: integer monthlyFundingCents: type: integer upcomingPulls: type: array items: type: object properties: date: type: string format: date amountCents: type: integer status: type: string example: scheduled recentPulls: type: array items: type: object properties: date: type: string format: date amountCents: type: integer status: type: string example: scheduled premiums: type: object properties: monthlyPremiumEquivalentCents: type: integer pepmCents: type: integer employeeContributionCents: type: integer const: 0 breakdown: type: array description: >- Premium-equivalent allocation. Sums to `monthlyPremiumEquivalentCents`. items: type: object properties: label: type: string cents: type: integer spend: type: object properties: mtdCents: type: integer ytdCents: type: integer categories: type: array items: type: object properties: category: type: string cents: type: integer pct: type: number suppressed: type: boolean description: >- `true` when category-level spend is withheld because the group is small enough that a category could identify individuals. Render the `suppressionNote` instead of the chart. suppressionNote: type: string example: >- Spend categories are hidden for small groups to protect member privacy. savings: type: object properties: baselineAnnualCents: type: integer description: Prior plan cost projected over the plan year. savingsYtdCents: type: integer Error: type: object required: - error - message properties: error: type: string enum: - unauthorized - live_mode_disabled - forbidden - not_found - invalid_request - conflict - quote_expired - census_required - rate_limited - server_error - not_configured description: Stable machine-readable error code. message: type: string description: >- Human-readable explanation. Wording may change; branch on `error`, not `message`. details: type: array description: Present on `invalid_request`. One entry per failed field. items: type: object required: - field - message properties: field: type: string example: zip message: type: string example: zip must be a 5-digit ZIP code index: type: integer description: >- For array payloads (census rows), the zero-based index of the failing row. example: 7 responses: Unauthorized: description: Missing, malformed, or revoked API key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: unauthorized message: >- Provide a valid partner API key as `Authorization: Bearer psk_...`. RateLimited: description: Rate limit exceeded. Honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: rate_limited message: Rate limit exceeded. Retry after 12 seconds. headers: Retry-After: description: Seconds to wait before retrying. schema: type: integer example: 12 ServerError: description: >- Something failed on our side. Safe to retry with the same `Idempotency-Key`. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: server_error message: Internal error. The request was not applied. securitySchemes: bearerAuth: type: http scheme: bearer description: >- Partner API key. `psk_test_<32 hex>` for test mode, `psk_live_<32 hex>` for live mode. Keys are stored hashed and cannot be recovered; store them in your secrets manager on issue. ````