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

## 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
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `version` integer, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)