curl --request POST \
--url https://www.getprescience.com/api/partner/v1/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_name": "Acme Inc",
"domain": "acme.com",
"contact": {
"name": "Dana Park",
"email": "dana@acme.com"
}
}
'{
"id": "grp_8c2f41d09a3e",
"mode": "test",
"status": "created",
"company_name": "Acme Inc",
"domain": "acme.com",
"external_id": "co_4821",
"address": {
"line1": "548 Market St",
"city": "San Francisco",
"state": "CA",
"zip": "94104"
},
"contact": {
"name": "Dana Park",
"email": "dana@acme.com",
"title": "Head of People"
},
"current_coverage": {
"plan_type": "fully_insured",
"carrier": "Anthem",
"pepm_cents": 80000,
"renewal_date": "2026-09-01"
},
"census_member_count": 0,
"company_state": null,
"created_at": "2026-06-10T17:04:11Z",
"updated_at": "2026-06-10T17:04:11Z"
}Create a group
Creates an employer account from four required values: company_name, domain, contact.name, and contact.email. Prior coverage, prior PEPM, address, title, and external ID are not required. Field names are snake_case for broker keys. HR platform partners use camelCase (company_name is companyName).
curl --request POST \
--url https://www.getprescience.com/api/partner/v1/groups \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"company_name": "Acme Inc",
"domain": "acme.com",
"contact": {
"name": "Dana Park",
"email": "dana@acme.com"
}
}
'{
"id": "grp_8c2f41d09a3e",
"mode": "test",
"status": "created",
"company_name": "Acme Inc",
"domain": "acme.com",
"external_id": "co_4821",
"address": {
"line1": "548 Market St",
"city": "San Francisco",
"state": "CA",
"zip": "94104"
},
"contact": {
"name": "Dana Park",
"email": "dana@acme.com",
"title": "Head of People"
},
"current_coverage": {
"plan_type": "fully_insured",
"carrier": "Anthem",
"pepm_cents": 80000,
"renewal_date": "2026-09-01"
},
"census_member_count": 0,
"company_state": null,
"created_at": "2026-06-10T17:04:11Z",
"updated_at": "2026-06-10T17:04:11Z"
}Authorizations
Partner API key. psk_test_<32 hex> for test mode, psk_live_<32 hex> for live mode. Store them in your secrets manager on issue. Live keys are shown once; the scoped partner portal can show an active sandbox key again.
Headers
Any non-empty string; deterministic keys from your own IDs work best. Repeating the same key with the same body on the same endpoint and mode within 24 hours returns the stored successful response (with Idempotent-Replay: true) instead of re-executing. Error responses are not stored.
Body
- Option 1
- Option 2
The group fields. On PATCH, send only the fields you are changing.
"Acme Inc"
Primary company domain. One enrolled group per domain per mode.
"acme.com"
Show child attributes
Show child attributes
Your internal employer ID. Echoed back on the group and useful for reconciliation.
"co_4821"
"Acme Incorporated"
"94-2404110"
Show child attributes
Show child attributes
Optional historical coverage metadata. It is not required for market-rate quotes.
Show child attributes
Show child attributes
What a carrier needs to know about the group's plan before it quotes. Every field is optional. On PATCH, send only the fields you are changing; a field sent as null is cleared.
Show child attributes
Show child attributes
Response
Group created.
- Option 1
- Option 2
"grp_8c2f41d09a3e"
test, live Lifecycle: created -> census_received -> quoted -> enrolled -> active (active = company flipped to prod by Prescience).
created, census_received, quoted, enrolled, active "Acme Inc"
"acme.com"
12
Registered legal name, when you sent one.
Your internal employer ID.
"co_4821"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Optional historical coverage metadata. It is not required for market-rate quotes.
Show child attributes
Show child attributes
Present once you have set any plan design field.
Show child attributes
Show child attributes
Present once the client's move-forward request was recorded with POST /groups/{groupId}/move-forward.
Show child attributes
Show child attributes
Brokers only. Always 0: plans sent in market_plans are no longer used.
Present once the client's move-forward request was recorded: the carrier and plan to submit for enrollment, and where enrollment stands.
Show child attributes
Show child attributes
null until enrolled, then sandbox, then prod once Prescience activates the group.
sandbox, prod, null