Pular para o conteúdo

API

Sessions and results.

A session is one candidate taking one interview. Its results are AI coverage of your expectations, for human review.

Última atualização: 19 de novembro de 2026

A documentação para desenvolvedores está disponível apenas em inglês.

Get a session

GET/v1/sessions/{id}Scope results:read

status is created, in_progress or finished. durationMs is set once it ended. endReason says why a finished session ended: completed (every block ran), candidate_ended (the candidate ended it early) or abandoned (they left and it timed out); endedEarly is true for the last two, so the results cover only the blocks they reached.

curl https://api.testee.ai/v1/sessions/Qx7vT2mKpL9nWb4sYc1e \  -H "Authorization: Bearer $TESTEE_API_KEY"
Response
{  "id": "Qx7vT2mKpL9nWb4sYc1e",  "invitationId": "inv_mh3m8k1qz8x4pd",  "candidateId": "cand_4f1b9c0e7a2d5e8f3b6c9a1d0e4f",  "interviewId": "iv_mh3k2p9x4f7a2c",  "status": "finished",  "startedAt": "2026-11-12T14:00:12.000Z",  "endedAt": "2026-11-12T14:31:40.000Z",  "durationMs": 1888000,  "endedEarly": false,  "endReason": "completed"}

Get the results

GET/v1/sessions/{id}/resultsScope results:read

Wait for the results.ready webhook, or poll until analysisStatus is done or error: until then, blocks appear one by one, are pending or running, and the scores can be null. Reviewers' corrections in the dashboard are already applied.

curl https://api.testee.ai/v1/sessions/Qx7vT2mKpL9nWb4sYc1e/results \  -H "Authorization: Bearer $TESTEE_API_KEY"
Response
{  "sessionId": "Qx7vT2mKpL9nWb4sYc1e",  "status": "finished",  "overallScore": 78,  "mustHavesMet": true,  "endedEarly": false,  "analysisStatus": "done",  "decision": "undecided",  "partial": false,  "summary": "Explained the caching design clearly and covered most expectations; the failure-handling answer stayed general.",  "followUps": [    {      "question": "How would you retry a failed payment webhook without charging twice?",      "rationale": "Idempotency came up only after a prompt.",      "basedOn": [        "partial"      ],      "evidenceRefs": [        {          "blockId": "blk_design",          "expectationId": "exp_idempotency",          "utteranceId": "utt_0142"        }      ]    }  ],  "label": "Coverage of expectations, for review only, not a hiring decision.",  "consent": {    "acceptedAt": "2026-11-12T13:59:48.000Z",    "via": "web",    "items": [      {        "kind": "interview",        "version": "2026-11-11",        "textHash": "9f2c4e…"      }    ],    "identityVerifiedBy": null  },  "blocks": [    {      "blockId": "blk_design",      "status": "done",      "score": 74,      "summary": "Sound high-level design; partial on idempotency.",      "coverage": [        {          "expectationId": "exp_caching",          "status": "covered"        },        {          "expectationId": "exp_idempotency",          "status": "covered_after_prompt"        }      ]    }  ],  "resultsUrl": "https://app.testee.ai/c/co_acme/sessions/Qx7vT2mKpL9nWb4sYc1e",  "aiGenerated": {    "fields": [      "summary",      "followUps",      "blocks[].summary",      "blocks[].coverage[].status"    ],    "digitalSourceType": "http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia"  }}

Results fields

FieldTypeDescription
overallScoreinteger or null0 to 100: how much of the interview's expectations the answers covered
mustHavesMetbooleanWhether every must-have expectation was covered
analysisStatusstringThe analysis as a whole: pending, running, done (final, results.ready was sent) or error (failed; your team can retry it in the dashboard). Poll on this, not on the blocks
endedEarlybooleanThe candidate ended the interview before every block ran, or left it
decisionstringYour team's decision in the dashboard: undecided, advance, hold or reject
summarystring or nullThe AI's summary for the reviewer
followUpsarray5 to 8 suggested questions for a live follow-up interview, each with rationale, basedOn and evidenceRefs; empty while the analysis runs
blocks[]arrayPer block: status (pending, running, done, error), score, summary and coverage
blocks[].coverage[]arrayPer expectation: covered, partial, covered_after_prompt, not_covered or incorrect
consentobject or nullWhat the candidate agreed to before starting: when, web or embed, and each text's version and sha256. identityVerifiedBy is company when the invitation had skipSignIn (your site verified the candidate), else null
labelstringThe reminder to show with the scores: for review only, not a hiring decision
resultsUrlstringThe results page in the dashboard (sign-in needed)
aiGeneratedobjectWhich fields our AI wrote (fields) and the IPTC source type (digitalSourceType): the machine-readable mark of the EU AI Act, Art. 50(2). Scores are computed from the statuses, not by the AI