---
title: "List Prompts"
method: GET
path: "/prompts/list"
tags: ["Prompt Management"]
---

# List Prompts

`GET /prompts/list`

List the prompts that are available on the proxy server

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

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

Example Response:
```json
{
    "prompts": [
        {
            "prompt_id": "my_prompt_id",
            "litellm_params": {
                "prompt_id": "my_prompt_id",
                "prompt_integration": "dotprompt",
                "prompt_directory": "/path/to/prompts"
            },
            "prompt_info": {
                "prompt_type": "config"
            },
            "created_at": "2023-11-09T12:34:56.789Z",
            "updated_at": "2023-11-09T12:34:56.789Z"
        }
    ]
}
```

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

---

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