---
title: "✨ List prompts"
method: GET
path: "/api/prompts/"
tags: ["Prompts"]
---

# ✨ List prompts

`GET /api/prompts/`

List all prompts.

## Query parameters

- `ordering` string
- `page` integer
- `page_size` integer
- `search` string

## Response `200`

- PaginatedModelInterfaceSerializerGETList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ModelInterfaceSerializerGET[], required
    - `associated_projects` AssociatedProject[]
      - `id` integer, required
      - `title` string, nullable — Project name. Must be between 3 and 50 characters long.
    - `best_score` number, double, nullable, required
    - `created_at` string, date-time, required
    - `created_by` UserSimple — A ModelSerializer that takes additional arguments for "fields", "omit" and "expand" in order to control which fields are displayed, and whether to replace simple values with complex, nested serializations
      - `avatar` string, nullable, required
      - `email` string, email
      - `first_name` string
      - `id` integer, required
      - `last_name` string
      - `username` string, required
    - `description` string, nullable — Model description
    - `id` integer, required
    - `input_fields` unknown
    - `organization` integer, nullable
    - `output_classes` unknown
    - `runs_count` integer, required
    - `skill_name` 'TextClassification' | 'NamedEntityRecognition' — * `TextClassification` - TextClassification * `NamedEntityRecognition` - NamedEntityRecognition
    - `title` string, required — Model name
    - `updated_at` string, date-time, required
    - `versions_count` integer, required

## Changes

- **2026-07-08** `b5f055b9d45b` — 1 breaking
  - the response property `results/items/created_by/allOf[#/components/schemas/UserSimple]/avatar` became nullable for the status `200`
- **2026-04-28** `4c8b471479df` — 1 info
  - added the new optional `query` request parameter `page_size`
- **2026-04-27** `5281b5793e5f` — 1 breaking, 6 info
  - the response's body type/format changed from `array`/`` to `object`/`` for status `200`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `search`
  - added the optional property `next` to the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/humansignal/apis/label-studio-api/changes/api/prompts/get.md)

---

[API](https://skmtc.dev/humansignal/apis/label-studio-api.md) · [All operations](https://skmtc.dev/humansignal/apis/label-studio-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/humansignal/label-studio-api/revisions/c5d26dd00a92/schema)