# Query Prompts

> Search and filter prompts with pagination

`POST https://api.helicone.ai/v1/prompt-2025/query`

Retrieves a paginated list of prompts based on search criteria and tag filters.

### Request Body

<ParamField body="search" type="string" required>
  Search term to filter prompts by name
</ParamField>

<ParamField body="tagsFilter" type="string[]" required>
  Array of tags to filter prompts (shows prompts with any of these tags)
</ParamField>

<ParamField body="page" type="number" required>
  Page number for pagination (0-based)
</ParamField>

<ParamField body="pageSize" type="number" required>
  Number of prompts to return per page
</ParamField>

### Response

Returns an array of prompt objects matching the search criteria.

<ResponseField name="id" type="string">
  Unique identifier of the prompt
</ResponseField>

<ResponseField name="name" type="string">
  Name of the prompt
</ResponseField>

<ResponseField name="tags" type="string[]">
  Array of tags associated with the prompt
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO timestamp when the prompt was created
</ResponseField>