---
title: "List Alignment Projects"
method: GET
path: "/api/v3/alignment-projects/list"
tags: ["Alignment Projects"]
---

# List Alignment Projects

`GET /api/v3/alignment-projects/list`

## Request

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

List the caller's alignment projects as summary rows.

A list view renders an identifier, a name, a state and a timestamp, so that
is what this returns. The full record, documents, metrics and evaluation
details live on `GET /alignment-projects/{id}`.

**Query Parameters:**

- `status` (optional): Filter by alignment project status
- `limit` (optional): Number of alignment projects to return (1-100, default: 10)

Each row carries `model_id`, the aligned model the project produced, once it is READY, and `evaluation_id`, the evaluation created from its benchmark. Read the evaluation itself at `GET /evaluations/{evaluation_id}/status`.
- `offset` (optional): Number of alignment projects to skip for pagination (default: 0)

## Query parameters

- `status` string, nullable: Filter by alignment project status
- `limit` integer: Number of alignment projects to return
- `offset` integer: Number of alignment projects to skip

## Response `200`

Returns a summary row per alignment project: identifier, name, base model, status and timestamps.

- AlignmentProjectListResponse: The caller's alignment projects.
  - `alignment_projects` AlignmentProjectListItem[], required: The caller's alignment projects, one summary row each.
    - `alignment_id` string, required: Unique identifier of the alignment project.
    - `model_id` string, nullable: The aligned model this project produced, set once it is READY. An alignment produces at most one model.
    - `alignment_name` string, nullable: Display name of the project.
    - `base_model_id` string, nullable: Base model the project aligns.
    - `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, nullable: Creation timestamp.
    - `evaluation_id` string, nullable: The evaluation created from the project's benchmark once train-time alignment finished; null before that and for projects without a benchmark.

## 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)