---
title: "Get Task Instances"
method: GET
path: "/api/quality-checks/instances"
tags: ["quality-checks"]
---

# Get Task Instances

`GET /api/quality-checks/instances`

## Request

- Base URL: `https://api.mit-llm-survey.academy` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mit-llm-survey.academy/api/quality-checks/instances`
- Auth: none declared

Get task instances for quality checks.

**Filters:**
- is_deleted is null
- available: filtered by 'filter' param (if not specified, returns all records)

**Ordering:**
- Ordered by updated_at DESC

**Pagination:**
- limit: Number of items to return (default: 10, max: 100)
- skip: Number of items to skip (default: 0)

**Search:**
- search: Optional search string to filter by task_description (case-insensitive)

**Filter:**
- filter: Optional filter for task availability ("unavailable", "locked", "available"). If not provided, returns all records.

**Returns:**
- total: Total number of matching items
- limit: Limit used
- skip: Skip used
- items: Array of task instances with task_id, prolific_id, task_description, occupation_name

## Query parameters

- `limit` integer
- `skip` integer
- `search` string, nullable: Search string for task_description
- `filter` 'unavailable' | 'locked' | 'available', nullable: Filter by task availability status

## Response `200`

Successful Response

- TaskInstancesResponse: Model for task instances response with pagination
  - `total` integer, required
  - `limit` integer, required
  - `skip` integer, required
  - `items` TaskInstanceItem[], required
    - `task_id` string, required
    - `prolific_id` string, nullable, required
    - `task_description` string, required
    - `occupation_id` string, required
    - `occupation_name` string, required
    - `available` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend.md) - [All operations](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/mit-llm-survey/apis/llm-survey-backend/revisions/6a5ef49cfcc4?raw)