---
title: "Full prompt optimization (Stripe-subscription tier)"
method: POST
path: "/api/v1/optimize"
tags: ["paid", "stripe", "full"]
---

# Full prompt optimization (Stripe-subscription tier)

`POST /api/v1/optimize`

## Request

- Base URL: `https://promptqualityscore.com`
- URL: `https://promptqualityscore.com/api/v1/optimize`
- Auth: API key in header `Authorization`

Paid-tier Stripe-gated endpoint. Requires a bearer PQS_... API key attached to a solo/team/business/enterprise subscription. Returns optimized prompt + before/after scoring + both outputs.

## Request body

- object
  - `prompt` string, required: Prompt to score
  - `vertical` 'software' | 'content' | 'business' | 'education' | 'science' | 'crypto' | 'general' | 'research'

## Response `200`

Full optimization result

- object
  - `pqs_version` '2.0', required
  - `original` object, required
    - `prompt` string
    - `score` object
      - `total` integer
      - `out_of` 80
      - `grade` 'A' | 'B' | 'C' | 'D' | 'F'
      - `percentile` integer
      - `dimensions` object
        - `clarity` integer
        - `specificity` integer
        - `context` integer
        - `constraints` integer
        - `output_format` integer
        - `role_definition` integer
        - `examples` integer
        - `cot_structure` integer
        - `total` integer
    - `output` string
  - `optimized` object, required
    - `prompt` string
    - `score` object
      - `total` integer
      - `out_of` 80
      - `grade` 'A' | 'B' | 'C' | 'D' | 'F'
      - `percentile` integer
      - `dimensions` object
        - `clarity` integer
        - `specificity` integer
        - `context` integer
        - `constraints` integer
        - `output_format` integer
        - `role_definition` integer
        - `examples` integer
        - `cot_structure` integer
        - `total` integer
    - `output` string
  - `improvement_pct` integer
  - `explanation` string
  - `powered_by` string

## Other responses

- `401`: Invalid or missing API key
- `402`: Free tier cannot use this endpoint - subscribe at promptqualityscore.com/pricing
- `429`: Rate limited (per-tier)

---

[API](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score.md) · [All operations](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score/llms.txt) · [OpenAPI document](https://skmtc.dev/promptqualityscore/apis/pqs-prompt-quality-score/revisions/7f3f43a1c864?raw)