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

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.

GET https://www.promptbank.club/api/v1/prompts

Query Parameters

integer

default:20

The number of prompts to return per page. Must be between 1 and 100.

string

An opaque pagination cursor returned as pagination.nextCursor in a previous response. Omit this parameter to start from the beginning of the list.

integer

Filter results to only prompts that belong to the vault with this ID.

string

Filter results by prompt type. Accepted values: image, text, video.

Example Request

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

Example Response

{
  "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.

⌘I

Overview

Prompts

Vaults

Generations

Uploads

API Keys

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

Query Parameters

Example Request

Example Response

​Query Parameters

​Example Request

​Example Response

Query Parameters

Example Request

Example Response