Pro Logic · Scoring Engine API v2

Assessment scoring as a service

Send a registration and a person's questionnaire responses; get back ranked traits and narrative insights for each scope you are licensed for. Scoring is deterministic and driven by catalog data: each licensed product is an access code, and any result can be re-rendered later in any format or language.

Start here

How a scoring call works

  1. Authenticate every request with Authorization: Bearer <api key>. Keys are issued in the control panel and carry a default access code.
  2. POST /v2/assessments with the registration (name, language, and gender if known). You get an assessment id.
  3. PUT /v2/assessments/{id}/tools/{tool} for each questionnaire tool's responses. Responses are validated on write.
  4. POST /v2/assessments/{id}/score for the scopes you want. Scoring is synchronous; results come back in the same call and can be re-rendered later in any format or language.
  5. If your key has a webhook URL, the same result envelope is also POSTed there, signed with HMAC-SHA256 in X-Signature.

Questionnaire content, scope catalog and supported languages are available under /v2/reference/* so clients never hardcode them.