--- title: "Get simulation plan job" method: GET path: "/v1/simulation/plan/job/{jobId}" tags: ["Simulation Run Plan Job"] --- # Get simulation plan job `GET /v1/simulation/plan/job/{jobId}` Retrieve details of a simulation plan job including all associated simulation jobs (calls) ## Path parameters - `jobId` string, uuid, required ## Response `200` Successfully retrieved simulation plan job - object - `data` GetSimulationPlanJobResponse, required — Simulation run plan job with all associated simulation jobs - `simulationRunPlanJobId` string, uuid, required — ID of the simulation run plan job - `simulationRunPlanId` string, uuid, required — ID of the simulation run plan - `status` 'PENDING' | 'QUEUED' | 'CREATING_SNAPSHOTS' | 'CREATING_SIMULATIONS' | 'PREPARING_CAPACITY' | 'RUNNING_SIMULATIONS' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELLED' | 'CANCELLING' | 'ENDING_SIMULATIONS', required — Job status - `createdAt` string, required — When the job was created - `startedAt` string, nullable — When the job started - `endedAt` string, nullable — When the job ended - `simulationJobs` object[], required — List of simulation jobs (calls) in this run plan job - `simulationJobId` string, uuid, required — Simulation job ID - `status` 'PENDING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'TIMED_OUT' | 'CANCELLED' | 'CANCELLING', required — Job status - `processingStatus` 'PENDING' | 'CONNECTING' | 'WAITING_FOR_OUTBOUND_CALL' | 'SIMULATING' | 'ENDING' | 'ANALYZING' | 'WAITING_FOR_LIVE_CONVERSATION' | 'EVALUATING' | 'COLLECTING_METRICS' | 'COMPLETED', required — Processing status. PENDING until the job starts connecting. - `callId` string, uuid, nullable — ID of the call created for this simulation job. Null if the call has not been created yet. - `roarkPhoneNumber` string, nullable — Phone number provisioned by Roark for this simulation job in E.164 format. Null if the simulation job is queued and has not been assigned a phone number yet. - `persona` object, required - `id` string, uuid, required — Unique identifier of the persona - `name` string, required — The name the agent will identify as during conversations - `description` string, nullable — Human-readable description of the persona - `language` 'EN' | 'ES' | 'DE' | 'HI' | 'FR' | 'NL' | 'AR' | 'EL' | 'IT' | 'ID' | 'TH' | 'JA' | 'TL' | 'MS' | 'ZH' | 'TR' | 'PT' | 'HE', required — Primary language ISO 639-1 code for the persona - `secondaryLanguage` 'EN', nullable — Secondary language ISO 639-1 code for code-switching (e.g., Hinglish, Spanglish) - `understoodLanguages` string[], required — Languages the persona can understand. Multilingual combinations are limited by multilingual speech recognition support. - `accent` 'US' | 'US_X_SOUTH' | 'GB' | 'ES' | 'DE' | 'IN' | 'FR' | 'NL' | 'SA' | 'GR' | 'AU' | 'IT' | 'ID' | 'TH' | 'JP' | 'NZ' | 'PH' | 'SG' | 'MY' | 'HK' | 'TR' | 'PT' | 'IL', required — Accent of the persona, defined using ISO 3166-1 alpha-2 country codes with optional variants - `age` 'CHILD' | 'TEENAGER' | 'ADULT' | 'ELDERLY', required — How old the caller sounds and behaves. Only ages the persona's accent has a voice for are accepted; defaults to ADULT, which every accent supports. - `gender` 'MALE' | 'FEMALE', required — Gender of the persona - `backgroundNoise` 'NONE' | 'AIRPORT' | 'CHILDREN_PLAYING' | 'CITY' | 'COFFEE_SHOP' | 'DRIVING' | 'OFFICE' | 'THUNDERSTORM', required — Background noise setting - `speechPace` 'SUPER_SLOW' | 'SLOW' | 'NORMAL' | 'FAST' | 'SUPER_FAST', required — Speech pace of the persona - `speechClarity` 'CLEAR' | 'VAGUE' | 'RAMBLING', required — Speech clarity of the persona - `hasDisfluencies` boolean, required — Whether the persona uses filler words like "um" and "uh" - `baseEmotion` 'NEUTRAL' | 'CHEERFUL' | 'CONFUSED' | 'FRUSTRATED' | 'SKEPTICAL' | 'RUSHED' | 'DISTRACTED', required — Base emotional state of the persona - `intentClarity` 'CLEAR' | 'INDIRECT' | 'VAGUE', required — How clearly the persona expresses their intentions - `confirmationStyle` 'EXPLICIT' | 'VAGUE', required — How the persona confirms information - `memoryReliability` 'HIGH' | 'LOW', required — How reliable the persona's memory is - `responseTiming` 'RELAXED' | 'NORMAL' | 'QUICK', required — Controls how quickly the persona responds to pauses in conversation (QUICK, NORMAL, RELAXED) - `backstoryPrompt` string, nullable — Background story and behavioral patterns for the persona - `idleMessages` string[], nullable, required — Messages the persona will say when the agent goes silent during a call. null = "Automatic": language-appropriate defaults are used at call time. - `idleTimeoutSeconds` integer, required — Seconds of silence before the persona sends an idle message - `idleMessageMaxSpokenCount` integer, required — Maximum number of idle messages the persona will send before giving up - `idleMessageResetCountOnUserSpeechEnabled` boolean, required — Whether the idle message counter resets when the agent speaks - `properties` object, required — Additional custom properties about the persona - `createdAt` string, required — Creation timestamp - `updatedAt` string, required — Last update timestamp - `scenario` ScenarioResponse, required — Scenario used in a simulation - `id` string, uuid, required — Scenario ID - `description` string, nullable — Scenario description - `agentEndpoint` AgentEndpointResponse, required — Agent endpoint used in a simulation - `id` string, uuid, required — Agent endpoint ID - `name` string, required — Agent endpoint name - `phoneNumber` string, nullable, required — Agent endpoint phone number - `type` 'PHONE' | 'WEBSOCKET' | 'LIVEKIT' | 'SMALL_WEBRTC' | 'ELEVENLABS_WS' | 'KORE' | 'GOOGLE_CES' | 'DAILY', required — Agent endpoint type - `createdAt` string, required — When the simulation job was created - `startedAt` string, nullable — When the simulation job started - `completedAt` string, nullable — When the simulation job completed ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Simulation plan job not found - `429` — Too Many Requests - `500` — Internal Server Error ## Changes - **2026-09-03** `6a09e09bd1ca` — 1 info - added the non-success response with the status `400` - **2026-08-26** `b4a59c7057ca` — 1 breaking, 7 info - the response's body type changed from no type to `object` for status `404` - for the `path` request parameter `jobId`, the type was generalized from no type to `string`, and format from no format to `uuid` - added the optional property `details` to the response with the `404` status - added the optional property `param` to the response with the `404` status - …4 more - **2026-08-20** `9080f2313118` — 1 warning - added the new `PREPARING_CAPACITY` enum value to the `data/status` response property for the response status `200` - **2026-08-17** `887b091b3d81` — 1 breaking, 13 warning, 4 info - the response property `data/simulationJobs/items/persona/idleMessages` became nullable for the status `200` - added the new `DAILY` enum value to the `data/simulationJobs/items/agentEndpoint/type` response property for the response status `200` - added the new `HE` enum value to the `data/simulationJobs/items/persona/language` response property for the response status `200` - added the new `IL` enum value to the `data/simulationJobs/items/persona/accent` response property for the response status `200` - …14 more - …earlier changes not shown [Full history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/simulation/plan/job/:jobId/get.md) --- [API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) · [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/roarkhq/roark-analytics-api/revisions/7bed4709abaa/schema)