> ## Documentation Index
> Fetch the complete documentation index at: https://docs.promptbank.club/llms.txt
> Use this file to discover all available pages before exploring further.

# List Prompts — GET /api/v1/prompts | Prompt Bank

> Retrieve a paginated list of your prompts. Filter by vault or type, and use cursor-based pagination to walk through large collections efficiently.

Retrieve a paginated list of all prompts belonging to your account. You can narrow results by vault or prompt type, and use cursor-based pagination to walk through large collections efficiently.

<Note>
  **GET** `https://www.promptbank.club/api/v1/prompts`
</Note>

## Query Parameters

<ParamField query="limit" type="integer" default={20}>
  The number of prompts to return per page. Must be between **1** and **100**.
</ParamField>

<ParamField query="cursor" type="string">
  An opaque pagination cursor returned as `pagination.nextCursor` in a previous response. Omit this parameter to start from the beginning of the list.
</ParamField>

<ParamField query="vaultId" type="integer">
  Filter results to only prompts that belong to the vault with this ID.
</ParamField>

<ParamField query="type" type="string">
  Filter results by prompt type. Accepted values: `image`, `text`, `video`.
</ParamField>

## Example Request

```bash theme={null}
curl -G https://www.promptbank.club/api/v1/prompts \
  -H 'Authorization: Bearer pb_live_...' \
  -d limit=2 \
  -d type=image
```

## Example Response

```json theme={null}
{
  "data": [
    {
      "id": 42,
      "title": "Cinematic sunset portrait",
      "prompt": "A cinematic portrait at golden hour, warm tones, shallow depth of field",
      "promptType": "image",
      "platform": "fal.ai",
      "status": "active",
      "images": [],
      "vaultIds": [7],
      "createdAt": "2024-06-01T12:00:00Z",
      "updatedAt": "2024-06-01T12:05:00Z"
    },
    {
      "id": 43,
      "title": "Foggy mountain landscape",
      "prompt": "A misty mountain range at dawn, cool blues and greens, epic wide angle",
      "promptType": "image",
      "platform": "fal.ai",
      "status": "active",
      "images": [],
      "vaultIds": [7, 12],
      "createdAt": "2024-06-02T09:15:00Z",
      "updatedAt": "2024-06-02T09:15:00Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6NDN9"
  },
  "error": null
}
```

When `pagination.nextCursor` is `null`, you have reached the last page of results.


## Related topics

- [Retrieve a Prompt — GET /api/v1/prompts/{promptId}](/api-reference/prompts/get.md)
- [Create and Manage Prompts via the Prompt Bank API](/guides/manage-prompts.md)
- [GET /api/v1/vaults/{vaultId}/prompts — List Vault Prompts](/api-reference/vaults/list-prompts.md)