---
title: "Get Prompt Versions"
method: GET
path: "/prompts/{prompt_id}/versions"
tags: ["Prompt Management"]
---

# Get Prompt Versions

`GET /prompts/{prompt_id}/versions`

Get all versions of a specific prompt by base prompt ID

👉 [Prompt docs](https://docs.litellm.ai/docs/proxy/prompt_management)

Example Request:
```bash
curl -X GET "http://localhost:4000/prompts/jack_success/versions" \
    -H "Authorization: Bearer <your_api_key>"
```

Example Response:
```json
{
    "prompts": [
        {
            "prompt_id": "jack_success.v1",
            "litellm_params": {...},
            "prompt_info": {"prompt_type": "db"},
            "created_at": "2023-11-09T12:34:56.789Z",
            "updated_at": "2023-11-09T12:34:56.789Z"
        },
        {
            "prompt_id": "jack_success.v2",
            "litellm_params": {...},
            "prompt_info": {"prompt_type": "db"},
            "created_at": "2023-11-09T13:45:12.345Z",
            "updated_at": "2023-11-09T13:45:12.345Z"
        }
    ]
}
```

## Path parameters

- `prompt_id` string, required

## Query parameters

- `environment` string, nullable

## Response `200`

Successful Response

- ListPromptsResponse
  - `prompts` PromptSpec[], required
    - `prompt_id` string, required
    - `litellm_params` PromptLiteLLMParams, required
      - `prompt_id` string, nullable
      - `prompt_integration` string, required
      - `api_base` string, nullable
      - `api_key` string, nullable
      - `provider_specific_query_params` object, nullable
      - `ignore_prompt_manager_model` boolean, nullable
      - `ignore_prompt_manager_optional_params` boolean, nullable
      - `dotprompt_content` string, nullable
    - `prompt_info` PromptInfo, required
      - `prompt_type` 'config' | 'db', required
      - `environment` string, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `version` integer, nullable
    - `environment` string, nullable
    - `created_by` string, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-21** `6246f8d427b7` — 2 info
  - api tag `Prompt Management` added
  - api tag `prompts` removed
- **2026-09-19** `c357baf422ab` — 2 info
  - api tag `prompts` added
  - api tag `Prompt Management` removed
- **2026-09-18** `082b5fabd909` — 4 info
  - api tag `Prompt Management` added
  - api tag `prompts` removed
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-17** `e2f308355e2d` — 2 info
  - api tag `prompts` added
  - api tag `Prompt Management` removed
- **2026-09-12** `0915d6a9ba99` — 2 info
  - api tag `Prompt Management` added
  - api tag `prompts` removed

[Full history](https://skmtc.dev/flock/apis/litellm-api/changes/prompts/:prompt_id/versions/get.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flock/apis/litellm-api/revisions/731afbea6a1b?raw)