> ## 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 Benchmark Data

> Retrieve complete benchmark data with all questions and answers.


This endpoint returns the full benchmark dataset including all questions, expected answers, and metadata. Use this to access the complete benchmark content for evaluation or review.


**Path Parameters:**

- `id`: Unique benchmark identifier


**Returns:**

- `benchmark_id`: Benchmark identifier
- `benchmark_name`: Name of the benchmark
- `status`: Benchmark status
- `documents`: List of document IDs (single-element array for uploaded benchmarks, multiple elements for generated benchmarks)
- `num_questions`: Total number of questions
- `questions`: Full list of benchmark questions with answers
- `created_at`: Creation timestamp
- `updated_at`: Last update timestamp


**Raises:**

- `404`: If benchmark not found or user doesn't have access


**Example Request:**

```json
GET /api/v3/benchmark/task-abc123/data
Headers: {"Authorization": "Bearer <api_key>"}
```


**Example Response:**

```json
{
  "id": "task-abc123",
  "benchmark_name": "Benchmark_doc-123",
  "status": "READY",
  "documents": ["doc-123", "doc-456"],
  "num_questions": 2,
  "questions": [
    {
      "question_num": 1,
      "question": "What is the main purpose of the product?",
      "answer": "To provide real-time collaboration tools for distributed teams."
    },
    {
      "question_num": 2,
      "question": "How does the authentication system work?",
      "answer": "Uses OAuth 2.0 with JWT tokens for secure authentication."
    }
  ],
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:32:45Z"
}
```


**Notes:**

- Only returns benchmarks owned by the user
- Contains complete question and answer data for evaluation
- Use this endpoint when you need the full benchmark content (not just metadata)



## OpenAPI

````yaml https://api.nugen.in/openapi-public.json get /api/v3/benchmark/{id}/data
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/benchmark/{id}/data:
    get:
      tags:
        - Benchmark
      summary: Get Benchmark Data
      description: >-
        Retrieve complete benchmark data with all questions and answers.



        This endpoint returns the full benchmark dataset including all
        questions, expected answers, and metadata. Use this to access the
        complete benchmark content for evaluation or review.



        **Path Parameters:**


        - `id`: Unique benchmark identifier



        **Returns:**


        - `benchmark_id`: Benchmark identifier

        - `benchmark_name`: Name of the benchmark

        - `status`: Benchmark status

        - `documents`: List of document IDs (single-element array for uploaded
        benchmarks, multiple elements for generated benchmarks)

        - `num_questions`: Total number of questions

        - `questions`: Full list of benchmark questions with answers

        - `created_at`: Creation timestamp

        - `updated_at`: Last update timestamp



        **Raises:**


        - `404`: If benchmark not found or user doesn't have access



        **Example Request:**


        ```json

        GET /api/v3/benchmark/task-abc123/data

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

        ```



        **Example Response:**


        ```json

        {
          "id": "task-abc123",
          "benchmark_name": "Benchmark_doc-123",
          "status": "READY",
          "documents": ["doc-123", "doc-456"],
          "num_questions": 2,
          "questions": [
            {
              "question_num": 1,
              "question": "What is the main purpose of the product?",
              "answer": "To provide real-time collaboration tools for distributed teams."
            },
            {
              "question_num": 2,
              "question": "How does the authentication system work?",
              "answer": "Uses OAuth 2.0 with JWT tokens for secure authentication."
            }
          ],
          "created_at": "2024-01-15T10:30:00Z",
          "updated_at": "2024-01-15T10:32:45Z"
        }

        ```



        **Notes:**


        - Only returns benchmarks owned by the user

        - Contains complete question and answer data for evaluation

        - Use this endpoint when you need the full benchmark content (not just
        metadata)
      operationId: get_benchmark_data
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            title: Id
      responses:
        '200':
          description: >-
            Returns the full benchmark data including all questions and answers
            for a specific benchmark
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BenchmarkFullResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    BenchmarkFullResponse:
      properties:
        benchmark_id:
          type: string
          title: Benchmark Id
          description: Benchmark ID
          example: benchmark-123
        benchmark_name:
          type: string
          title: Benchmark Name
          description: Name of the benchmark
          example: Customer Support Q&A
        status:
          $ref: '#/components/schemas/TaskStatus'
          description: Benchmark status
          example: PROCESSING
        s3_key:
          anyOf:
            - type: string
            - type: 'null'
          title: S3 Key
          description: S3 storage key
        s3_url:
          anyOf:
            - type: string
            - type: 'null'
          title: S3 Url
          description: S3 download URL
          example: https://s3.amazonaws.com/benchmark-123.zip
        document_ids:
          items:
            type: string
          type: array
          title: Document Ids
          description: Document IDs used for generation
          example:
            - doc-abc123
            - doc-def456
        num_questions:
          type: integer
          title: Num Questions
          description: Total number of questions
          example: 10
        questions:
          items:
            $ref: '#/components/schemas/BenchmarkQuestion'
          type: array
          title: Questions
          description: Complete list of benchmark questions
          example:
            - answer: Our return policy allows returns within 30 days of purchase.
              question: What is the return policy?
              question_num: 1
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Creation timestamp
          example: '2024-01-15T10:30:00Z'
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Last update timestamp
          example: '2024-01-15T12:30:00Z'
        source:
          type: string
          title: Source
          description: Data source
        metadata:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Metadata
          description: Additional metadata
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
          description: Error message if data fetch failed
      type: object
      required:
        - benchmark_id
        - benchmark_name
        - status
        - num_questions
        - created_at
        - updated_at
        - source
      title: BenchmarkFullResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    TaskStatus:
      type: string
      enum:
        - PROCESSING
        - READY
        - FAILED
        - DEPLOYING
        - EVALUATING
        - UNDEPLOYED
        - EVALUATED
        - STOPPED
      title: TaskStatus
    BenchmarkQuestion:
      properties:
        question_num:
          type: integer
          title: Question Num
          description: Question number
        question:
          type: string
          title: Question
          description: Question text
        answer:
          type: string
          title: Answer
          description: Answer text
      type: object
      required:
        - question_num
        - question
        - answer
      title: BenchmarkQuestion
    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

````