Check simulation

GET /v1/api/simulations/{job_id} Requires studies:read

Track a simulation started with Simulate an interview and read its sample transcript. The response carries the turns produced so far, so you can render the conversation while it runs; once status is completed the transcript is final. Simulated interviews are a Test-mode action — they are never counted, analysed, or exported as real interviews.

Parameters

job_id path required

string

Responses

200 Successful Response

status

string required

Derived simulation status: 'queued', 'running', 'completed', or 'failed'.

ready

boolean required

True only when the simulation completed and the transcript is final.

SimulationTranscriptTurn[] required

The sample transcript so far, oldest first. Grows while the simulation runs; final once status is 'completed'. Simulated interviews are a Test-mode action — they use no credits, provide no analysis or exports, and never appear as real participant interviews.

error

string · nullable

Why the simulation failed, when status is 'failed'.

422 Validation Error

ValidationError[]

cURL

curl 'https://api.heyjuno.co/v1/api/simulations/3fa85f64-5717-4562-b3fc-2c963f66afa6' \
  -H 'Authorization: Bearer $JUNO_API_KEY'

Example response

{
  "status": "string",
  "ready": true,
  "turns": [
    {
      "speaker": "interviewer",
      "text": "string",
      "turn_number": 0
    }
  ],
  "error": "string"
}