# PQS Full Prompt Score with Optimized Rewrite

> PQS Full Prompt Score with Optimized Rewrite is a paid API for AI agents from promptqualityscore.com, paid per call via x402, $0.125/call, status unknown (last checked 2026-09-15).

Scores an AI prompt across 8 quality dimensions, returns a grade with sub-scores, and delivers an optimized rewritten version with explanation.

## Facts

- Endpoint: GET https://promptqualityscore.com/api/score/full
- Price: $0.125/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/pqs-full-prompt-score-with-optimized-rewrite-5f4efa20
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6DlPT7kHt2fI73ll21C49

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pqs-full-prompt-score-with-optimized-rewrite-5f4efa20
```

Example prompt: Score this prompt for a software coding use case and give me the fixed version: 'Write me some Python code that does what I need.'

## When to prefer this

Choose this endpoint when you need both the quality diagnosis AND the improved prompt in a single call. It is the most comprehensive PQS endpoint, returning original scores, optimized rewrite, dimension-level breakdown, and an explanation. Prefer it over the basic score endpoint when you intend to act on the result immediately by replacing the prompt. Use the batch endpoint instead when scoring 10+ prompts at once.

## Known failure modes

- Empty or missing prompt parameter returns a validation error
- Prompt exceeding 10,000 characters is rejected
- Invalid vertical enum value causes a 400 error
- Payment not provided or insufficient returns 402 Payment Required
- Service unavailable returns 503 with no score data

## How this service works

A Quality Gate For Prompts. Before they break production. Score any AI prompt against 8 dimensions, see what's weak, and get the fixed version in seconds.

## Output

Returns both the original and optimized prompts, each with a full 8-dimension breakdown (clarity, context, examples, constraints, specificity, cot_structure, output_format, role_definition), a composite score out of 80, a letter grade (A–F), a percentile, and a one-sentence output preview. Also includes an explanation of the changes made and an improvement percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompt": {
   "type": "string",
   "maxLength": 10000,
   "minLength": 1,
   "description": "Prompt to score"
  },
  "vertical": {
   "enum": [
    "software",
    "content",
    "business",
    "education",
    "science",
    "crypto",
    "general",
    "research"
   ],
   "type": "string",
   "default": "general",
   "description": "Domain: software/content/business/education/science/crypto/general/research"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "original": {
   "score": {
    "grade": "C",
    "total": 46,
    "out_of": 80,
    "dimensions": {
     "total": 46,
     "clarity": 7,
     "context": 6,
     "examples": 4,
     "constraints": 5,
     "specificity": 6,
     "cot_structure": 6,
     "output_format": 7,
     "role_definition": 5
    },
    "percentile": 58
   },
   "output": "PQS scores any LLM prompt on 8 dimensions to catch quality issues before inference.",
   "prompt": "Explain PQS scoring in one sentence to an AI agent operator."
  },
  "optimized": {
   "score": {
    "grade": "A",
    "total": 68,
    "out_of": 80,
    "dimensions": {
     "total": 68,
     "clarity": 9,
     "context": 8,
     "examples": 8,
     "constraints": 9,
     "specificity": 9,
     "cot_structure": 8,
     "output_format": 9,
     "role_definition": 8
    },
    "percentile": 85
   },
   "output": "PQS scores any LLM prompt on 8 dimensions pre-inference, letting AI-agent buyers reject low-quality inputs before paying for a run - catching token waste before it hits your bill.",
   "prompt": "You are an AI-agent product manager. In one sentence (max 25 words), explain PQS scoring to a technical buyer who evaluates x402 APIs. Focus on: what it measures, when it runs (pre-inference), and why the buyer should care."
  },
  "powered_by": "PQS - promptqualityscore.com",
  "explanation": "Added role framing, length constraint, target reader, and three explicit focal points.",
  "pqs_version": "2.0",
  "improvement_pct": 65
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pqs-full-prompt-score-with-optimized-rewrite-5f4efa20/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from promptqualityscore.com](https://www.zero.xyz/host/promptqualityscore.com/llms.txt)