---
title: "List Benchmarks"
method: GET
path: "/api/v3/benchmarks/list"
tags: ["Benchmarks"]
---

# List Benchmarks

`GET /api/v3/benchmarks/list`

## Request

- Base URL: `https://api.nugen.in`
- URL: `https://api.nugen.in/api/v3/benchmarks/list`
- Auth: HTTP bearer

Retrieve all benchmarks for the user.


This endpoint returns a paginated list of all benchmarks created or uploaded by the user, including both generated and manually uploaded benchmarks.


**Query Parameters:**

- `status` (optional): Filter by benchmark status
- `limit` (optional): Number of benchmarks to return (1-100, default: 10)
- `offset` (optional): Number of benchmarks to skip for pagination (default: 0)


**Returns:**

- `benchmarks`: List of benchmark objects, each containing:
  - `benchmark_id`: Unique benchmark identifier
  - `benchmark_name`: Display name of the benchmark
  - `status`: Benchmark status (`PROCESSING`, `READY`, `UPLOADED`)
  - `created_at`: Timestamp when benchmark was created


**Example Request:**

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


**Example Response:**

```json
{
  "benchmarks": [
    {
      "benchmark_id": "benchmark_01k4x9m2p7q3r6a1",
      "benchmark_name": "Benchmark_document_01k4x9m2p7q3r5se",
      "status": "READY",
      "created_at": "2024-01-15T10:30:00Z"
    },
    {
      "benchmark_id": "benchmark_01k4x9m2p7q3r6a2",
      "benchmark_name": "Benchmark_document_01k4x9m2p7q3r5sg",
      "status": "uploaded",
      "created_at": "2024-01-16T14:20:00Z"
    }
  ]
}
```

## Query parameters

- `status` string, nullable: Filter by benchmark status
- `limit` integer: Number of benchmarks to return
- `offset` integer: Number of benchmarks to skip

## Response `200`

Returns a list of all benchmarks created or uploaded by the user, including both generated and manually uploaded benchmarks

- BenchmarkListResponse: The caller's benchmarks.
  - `benchmarks` BenchmarkListItem[], required: List of benchmarks
    - `benchmark_id` string, required: Benchmark ID
    - `benchmark_name` string, required: Name of the benchmark
    - `status` 'QUEUED' | 'PROCESSING' | 'READY' | 'FAILED' | 'STOPPED', required: Lifecycle status of a resource that runs asynchronously. Stored as is and returned as is, with no translation in between. - `QUEUED`: accepted and waiting for its workflow to start - `PROCESSING`: running - `READY`: finished successfully - `FAILED`: failed at any stage - `STOPPED`: stopped by the user before completion
    - `created_at` string, date-time, required: Creation timestamp

## Other responses

- `401`: Invalid API key
- `403`: Authorization header missing or not a Bearer token
- `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)