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

# Get Prompt Version by Environment

> Retrieve a prompt version for a specific environment

Retrieves the prompt version assigned to a specific environment (e.g., production, staging, development).

### Request Body

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

<ParamField body="environment" type="string" required>
  The environment to query (e.g., "production", "staging", "development")
</ParamField>

### Response

<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="environment" type="string">
  The environment this version is assigned to
</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
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.helicone.ai/v1/prompt-2025/query/environment-version" \
    -H "Authorization: Bearer $HELICONE_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "promptId": "prompt_123",
      "environment": "production"
    }'
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch('https://api.helicone.ai/v1/prompt-2025/query/environment-version', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${HELICONE_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      promptId: "prompt_123",
      environment: "production"
    }),
  });

  const version = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "version_789",
    "model": "gpt-4",
    "prompt_id": "prompt_123",
    "major_version": 2,
    "minor_version": 0,
    "commit_message": "Production release v2.0",
    "environment": "production",
    "created_at": "2024-01-20T14:00:00Z",
    "s3_url": "https://s3.amazonaws.com/bucket/prompt-body.json"
  }
  ```
</ResponseExample>