> ## Documentation Index > Fetch the complete documentation index at: https://docs.support.onclarity.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an eval run's status > A light read for polling: the run's state (`not_started`, `in_progress`, `paused`, `failed`, `completed`), the reason it paused itself if it did, and a progress breakdown of calls and grading with an estimated time remaining. ## OpenAPI ````yaml /api-reference/voice-openapi.json get /v1/projects/{projectId}/eval-submissions/{id}/status openapi: 3.0.3 info: title: Clarity Voice API version: '1.0' description: Voice agents, outbound calls, conversations, campaigns, and evals. servers: - url: https://voice-api.onclarity.com security: - organizationApiKey: [] tags: - name: Projects description: >- The projects your organization owns. Every other resource lives in a project. - name: Agents description: Create, configure, version and publish voice agents. - name: Outbound calls description: Have a published agent phone a number now. - name: Conversations description: >- One record per call session, with its calls, recordings, transcripts and artifacts. - name: Calls description: The calls of a project, with their status, direction, timing and outcome. - name: Campaigns description: Outbound calling campaigns that phone a list of numbers on a schedule. - name: Eval suites description: >- Reusable sets of eval scenarios and test cases to measure an agent against. - name: Eval judges description: The LLM judges that score eval calls against your test cases. - name: Eval scenarios description: The simulated-caller scenarios of your eval suites. - name: Eval test cases description: The checks a judge applies to each eval call. - name: Eval submissions description: Run an eval suite against an agent and read the verdicts. paths: /v1/projects/{projectId}/eval-submissions/{id}/status: parameters: - $ref: '#/components/parameters/ProjectIdPath' - name: id in: path required: true schema: type: string description: Eval submission id get: tags: - Eval submissions summary: Get an eval run's status description: >- A light read for polling: the run's state (`not_started`, `in_progress`, `paused`, `failed`, `completed`), the reason it paused itself if it did, and a progress breakdown of calls and grading with an estimated time remaining. operationId: getProjectEvalSubmissionStatus responses: '200': description: The run's status content: application/json: schema: $ref: '#/components/schemas/EvalSubmissionStatus' example: state: in_progress status: active error_message: null runs_completed: 1 runs_total: 2 judge_counts: pending: 0 in_progress: 0 done: 1 error: 0 error_final: 0 unusable: 0 progress: percent: 50 calls: total: 2 completed: 1 in_flight: 1 failed: 0 failed_infra: 0 queued: 0 judging: total: 1 done: 1 in_progress: 0 queued: 0 error: 0 error_retrying: 0 error_final: 0 unusable: 0 timing: started_at: '2026-10-22T14:05:00.000Z' last_activity_at: '2026-10-22T14:09:12.000Z' elapsed_ms: 252000 eta_ms: null '401': $ref: '#/components/responses/Unauthorized' '404': description: >- The project or eval submission does not exist, or your credential cannot see it. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Eval submission not found components: parameters: ProjectIdPath: name: projectId in: path required: true schema: type: string description: Project id schemas: EvalSubmissionStatus: type: object description: A light status read for polling a run. required: - state - status properties: state: type: string enum: - not_started - in_progress - paused - failed - completed status: type: string enum: - active - paused error_message: type: string nullable: true runs_completed: type: integer runs_total: type: integer judge_counts: $ref: '#/components/schemas/EvalSubmissionJudgeCounts' progress: $ref: '#/components/schemas/EvalSubmissionProgress' Error: type: object required: - error additionalProperties: true properties: error: type: string description: Error message code: type: string description: >- A stable machine-readable reason, present on the refusals a client may branch on. Among them: `PUBLISH_CAPABILITY_REQUIRED` (403, the credential may not change what is live), `AGENT_NOT_PUBLISHED` (409, the agent has no published version yet), `AGENT_TYPE_NOT_DISPATCHABLE` (422, a Voice Assist agent named where an agent must place or take a call; the body carries `agent_type` and `agent_id`), `NOT_APPLICABLE_TO_AGENT_TYPE` (422, a voice-only setting written on a Voice Assist agent), `AGENT_TYPE_BOUNDARY` (409), `AGENT_TYPE_NOT_SUPPORTED` (400), `VOICE_ASSISTANT_REQUIRED` (403, the organization is not licensed for Voice Assist), `ORGANIZATION_UNAVAILABLE` (503) and `REGION_PROFILE_CONFLICT` (503). EvalSubmissionJudgeCounts: type: object description: Calls of this run by grading state. properties: pending: type: integer in_progress: type: integer done: type: integer error: type: integer description: Grading failed; includes failures that will still be retried. error_final: type: integer description: Part of `error` that will not be retried. unusable: type: integer description: Part of `done` where every check came back as an error. EvalSubmissionProgress: type: object description: How far along the run is. properties: percent: type: number description: 0 to 100 calls: type: object properties: total: type: integer completed: type: integer in_flight: type: integer failed: type: integer failed_infra: type: integer description: >- Part of `failed` caused by the test harness rather than the agent. queued: type: integer judging: type: object properties: total: type: integer done: type: integer in_progress: type: integer queued: type: integer error: type: integer error_retrying: type: integer error_final: type: integer unusable: type: integer timing: type: object properties: started_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true elapsed_ms: type: number nullable: true eta_ms: type: number nullable: true responses: Unauthorized: description: No credential was sent, or the API key is invalid or revoked. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Invalid or revoked token securitySchemes: organizationApiKey: type: http scheme: bearer description: >- Your organization API key (it starts with `anek_org_`). The same key works on the Voice API and the Support API. See [Authentication](/authentication). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.