# Get Prompt Versions

> Retrieve all versions of a specific prompt

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

Retrieves all versions of a specific prompt, optionally filtered by major version.

### Request Body

<ParamField body="promptId" type="string" required>
  The unique identifier of the prompt
</ParamField>

<ParamField body="majorVersion" type="number" optional>
  Filter versions by specific major version number
</ParamField>

### Response

Returns an array of prompt version objects.

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

<ResponseField name="model" type="string">
  The model specified in the prompt
</ResponseField>

<ResponseField name="prompt_id" type="string">
  The ID of the parent prompt
</ResponseField>

<ResponseField name="major_version" type="number">
  The major version number
</ResponseField>

<ResponseField name="minor_version" type="number">
  The minor version number
</ResponseField>

<ResponseField name="commit_message" type="string">
  The commit message for this version
</ResponseField>

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

<ResponseField name="s3_url" type="string" optional>
  S3 URL where the prompt body is stored (if applicable)
</ResponseField>