---
title: "Get Completed Occupations"
method: GET
path: "/api/quality-checks/occupations"
tags: ["quality-checks"]
---

# Get Completed Occupations

`GET /api/quality-checks/occupations`

## 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/occupations`
- Auth: none declared

Get occupations for quality checks.

**Ordering:**
- Ordered by updated_at DESC

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

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

**Status Filter:**
- completed: completed_tasks equals total_tasks (and total_tasks > 0)
- in_progress: completed_tasks is greater than 0 but less than total_tasks
- pending: completed_tasks equals 0 (and total_tasks > 0)
- na: both completed_tasks and total_tasks are 0

**Returns:**
- total: Total number of matching occupations
- limit: Limit used
- skip: Skip used
- items: Array of occupation_id, occupation, total_tasks, completed_tasks

## Query parameters

- `limit` integer
- `skip` integer
- `search` string, nullable: Search string for occupation (case-insensitive)
- `status` 'completed' | 'in_progress' | 'pending' | 'na', nullable: Filter by status: completed (completed_tasks=total_tasks, total_tasks>0), in_progress (0<completed_tasks<total_tasks), pending (completed_tasks=0, total_tasks>0), na (both are 0)

## Response `200`

Successful Response

- CompletedOccupationsResponse: Model for completed occupations response with pagination
  - `total` integer, required
  - `limit` integer, required
  - `skip` integer, required
  - `items` CompletedOccupationItem[], required
    - `occupation_id` string, required
    - `occupation` string, required
    - `total_tasks` integer, required
    - `completed_tasks` integer, required

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