SME Onboarding Journey

A broker creates an employer account and binds a group health policy. All calls go directly to service ports (no gateway prefix in local dev).

Sequence Diagram

State Machine

API Reference

Step	Service	Method	Path	Auth
Get token	Keycloak	POST	/realms/olly/protocol/openid-connect/token	None
Create party	policy-admin	POST	/parties	Admin JWT
Create account	policy-admin	POST	/accounts	Admin JWT
List products	policy-admin	GET	/products/list	Admin JWT
List versions	policy-admin	GET	/products/{loc}/versions/list	Admin JWT
Create quote	broker-api	POST	/quotes	Broker JWT
Price quote	broker-api	PATCH	/quotes/{locator}/price	Broker JWT
Underwrite	broker-api	PATCH	/quotes/{locator}/underwrite	Broker JWT
Issue	broker-api	PATCH	/quotes/{locator}/issue	Broker JWT
Cancel policy	enrollment	PATCH	/policies/{locator}/cancel	Admin JWT