Healthspan Score APIPlanScout integration / QA
QA readyv1.4.0

Integration workspace

Validate the PlanScout intake-to-advisor insight handshake.

Open prototype OpenAPI YAML

OpenAPI 3.1

Oliver's transport contract, meeting-aligned result

Download spec
POST/oauth/token

Exchange PlanScout machine credentials for a Clerk token

POST/v1/intakes

Accept and classify Oliver's intake payload

GET/v1/intakes/{eventId}

Read qualitative result and callback state

GET/health

Verify deployment readiness

OAuth 2.0 + Clerk M2M

One-hour opaque bearer tokens are restricted to the PlanScout machine and Healthspan API scope.

At-least-once safe

Unique event IDs deduplicate intake and callback delivery retries.

Two presentation layers

The machine response includes the 0-100 score; client copy stays qualitative while advisor evidence remains inspectable.