> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nugen.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Evaluation Status

> Get the current status and progress of an evaluation.


This endpoint retrieves the status of a running or completed evaluation with detailed progress metrics. Use this to track progress and determine when results are ready.


**Path Parameters:**

- `evaluation_id`: Unique evaluation identifier


**Returns:**

- `evaluation_id`: The evaluation identifier
- `status`: Current status (`PROCESSING`, `READY`, `FAILED`)
- `benchmark_id`: The benchmark being used for evaluation
- `progress` (optional): Progress string (e.g., `"3/10 questions"`)
- `questions_completed` (optional): Number of questions completed so far
- `total_questions` (optional): Total number of questions in the benchmark
- `avg_time_per_question` (optional): Average time per question in seconds
- `eta_seconds` (optional): Estimated time remaining in seconds


**Raises:**

- `404`: If evaluation not found or doesn't belong to the authenticated user


**Example Request:**

```json
GET /api/v3/evaluations/eval-xyz789/status
Headers: {"Authorization": "Bearer <api_key>"}
```


**Example Response (Pending):**

```json
{
  "evaluation_id": "eval-xyz789",
  "status": "PROCESSING",
  "benchmark_id": "task-abc123",
  "progress": "0/10 questions",
  "questions_completed": 0,
  "total_questions": 10
}
```


**Example Response (In Progress):**

```json
{
  "evaluation_id": "eval-xyz789",
  "status": "PROCESSING",
  "benchmark_id": "task-abc123",
  "progress": "5/10 questions",
  "questions_completed": 5,
  "total_questions": 10,
  "avg_time_per_question": 12.5,
  "eta_seconds": 62
}
```


**Example Response (Completed):**

```json
{
  "evaluation_id": "eval-xyz789",
  "status": "READY",
  "benchmark_id": "task-abc123",
  "progress": "10/10 questions",
  "questions_completed": 10,
  "total_questions": 10,
  "avg_time_per_question": 11.8
}
```


**Notes:**

- Poll this endpoint to track evaluation progress
- Once status is `READY`, use `/evaluations/{evaluation_id}/results` to get full results
- Status `FAILED` indicates an error occurred during evaluation



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json get /api/v3/evaluations/{evaluation_id}/status
openapi: 3.1.0
info:
  title: Nugen Intelligence API
  description: 'Nugen Intelligence : Powering Specialized Intelligence At Scale'
  version: 25.4.20
servers: []
security: []
paths:
  /api/v3/evaluations/{evaluation_id}/status:
    get:
      tags:
        - Evaluations
      summary: Get Evaluation Status
      description: >-
        Get the current status and progress of an evaluation.



        This endpoint retrieves the status of a running or completed evaluation
        with detailed progress metrics. Use this to track progress and determine
        when results are ready.



        **Path Parameters:**


        - `evaluation_id`: Unique evaluation identifier



        **Returns:**


        - `evaluation_id`: The evaluation identifier

        - `status`: Current status (`PROCESSING`, `READY`, `FAILED`)

        - `benchmark_id`: The benchmark being used for evaluation

        - `progress` (optional): Progress string (e.g., `"3/10 questions"`)

        - `questions_completed` (optional): Number of questions completed so far

        - `total_questions` (optional): Total number of questions in the
        benchmark

        - `avg_time_per_question` (optional): Average time per question in
        seconds

        - `eta_seconds` (optional): Estimated time remaining in seconds



        **Raises:**


        - `404`: If evaluation not found or doesn't belong to the authenticated
        user



        **Example Request:**


        ```json

        GET /api/v3/evaluations/eval-xyz789/status

        Headers: {"Authorization": "Bearer <api_key>"}

        ```



        **Example Response (Pending):**


        ```json

        {
          "evaluation_id": "eval-xyz789",
          "status": "PROCESSING",
          "benchmark_id": "task-abc123",
          "progress": "0/10 questions",
          "questions_completed": 0,
          "total_questions": 10
        }

        ```



        **Example Response (In Progress):**


        ```json

        {
          "evaluation_id": "eval-xyz789",
          "status": "PROCESSING",
          "benchmark_id": "task-abc123",
          "progress": "5/10 questions",
          "questions_completed": 5,
          "total_questions": 10,
          "avg_time_per_question": 12.5,
          "eta_seconds": 62
        }

        ```



        **Example Response (Completed):**


        ```json

        {
          "evaluation_id": "eval-xyz789",
          "status": "READY",
          "benchmark_id": "task-abc123",
          "progress": "10/10 questions",
          "questions_completed": 10,
          "total_questions": 10,
          "avg_time_per_question": 11.8
        }

        ```



        **Notes:**


        - Poll this endpoint to track evaluation progress

        - Once status is `READY`, use `/evaluations/{evaluation_id}/results` to
        get full results

        - Status `FAILED` indicates an error occurred during evaluation
      operationId: get_evaluation_status
      parameters:
        - name: evaluation_id
          in: path
          required: true
          schema:
            type: string
            title: Evaluation Id
      responses:
        '200':
          description: >-
            Returns the current status and progress of an evaluation. This
            endpoint retrieves the status of a running or completed evaluation
            with detailed progress metrics, allowing users to track the
            evaluation process and determine when results are ready.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EvaluationStatusResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    EvaluationStatusResponse:
      properties:
        evaluation_id:
          type: string
          title: Evaluation Id
          description: Unique identifier for the evaluation
          example: eval-abc123
        status:
          type: string
          title: Status
          description: Current status (PROCESSING, READY, FAILED)
          example: PROCESSING
        benchmark_id:
          type: string
          title: Benchmark Id
          description: Benchmark ID used
          example: benchmark-abc123
        progress:
          anyOf:
            - type: string
            - type: 'null'
          title: Progress
          description: Progress string (e.g., '3/10 questions')
          example: 3/10 questions
        questions_completed:
          anyOf:
            - type: integer
            - type: 'null'
          title: Questions Completed
          description: Number of questions completed
          example: 3
        total_questions:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Questions
          description: Total number of questions
          example: 10
        avg_time_per_question:
          anyOf:
            - type: number
            - type: 'null'
          title: Avg Time Per Question
          description: Average time per question in seconds
          example: 15.5
        eta_seconds:
          anyOf:
            - type: integer
            - type: 'null'
          title: Eta Seconds
          description: Estimated time remaining in seconds
          example: 300
        start_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Start Time
          description: Timestamp when evaluation started
          example: '2024-02-24T10:00:00Z'
        end_time:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: End Time
          description: Timestamp when evaluation completed
          example: '2024-02-24T10:05:00Z'
      type: object
      required:
        - evaluation_id
        - status
        - benchmark_id
      title: EvaluationStatusResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````