---
title: "Get Generated Benchmark"
method: GET
path: "/api/v3/benchmarks/{benchmark_id}/data"
tags: ["Benchmarks"]
---

# Get Generated Benchmark

`GET /api/v3/benchmarks/{benchmark_id}/data`

## Request

- Base URL: `https://api.nugen.in`
- URL: `https://api.nugen.in/api/v3/benchmarks/{benchmark_id}/data`
- Auth: HTTP bearer

Retrieve complete benchmark data with all samples.


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


**Path Parameters:**

- `benchmark_id`: Unique benchmark identifier


**Returns:**

- `benchmark_id`: Benchmark identifier
- `document_ids`: List of document IDs (single-element array for uploaded benchmarks, multiple elements for generated benchmarks)
- `samples`: Full list of benchmark samples with their responses

Identity, status, and timestamps are served by `GET /{benchmark_id}`.


**Raises:**

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


**Example Request:**

```json
GET /api/v3/benchmarks/benchmark_01k4x9m2p7q3r6a1/data
Headers: {"Authorization": "Bearer <api_key>"}
```


**Example Response:**

```json
{
  "benchmark_id": "benchmark_01k4x9m2p7q3r6a1",
  "document_ids": ["document_01k4x9m2p7q3r5se", "document_01k4x9m2p7q3r5sf"],
  "samples": [
    {
      "sample_num": 1,
      "instruction": "What is the main purpose of the product?",
      "response": "To provide real-time collaboration tools for distributed teams."
    },
    {
      "sample_num": 2,
      "instruction": "How does the authentication system work?",
      "response": "Uses OAuth 2.0 with JWT tokens for secure authentication."
    }
  ]
}
```


**Notes:**

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

## Path parameters

- `benchmark_id` string, required

## Response `200`

Returns the benchmark's samples. Identity, status, and timestamps are served by GET /{benchmark_id}.

- BenchmarkDataResponse: The benchmark's sample payload. Identity, status and timestamps are served by GET /{benchmark_id}.
  - `benchmark_id` string, required: Benchmark ID
  - `document_ids` string[]: Document IDs used for generation
  - `samples` BenchmarkSample[]: Complete list of benchmark samples
    - `sample_num` integer, required: Sample number
    - `instruction` string, required: Instruction text
    - `response` string, required: Expected response text
    - `image_url` string, nullable: Image URL for vision samples
  - `metadata` object, nullable: Additional metadata
  - `error` string, nullable: Error message if data fetch failed

## Other responses

- `401`: Invalid API key
- `403`: Authorization header missing or not a Bearer token
- `404`: Resource not found
- `422`: Validation Error

---

[API](https://skmtc.dev/nugen/apis/nugen-intelligence-api.md) - [All operations](https://skmtc.dev/nugen/apis/nugen-intelligence-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nugen/apis/nugen-intelligence-api/revisions/62baa7960a4a?raw)