# PromptQualityScore Batch Scoring

> PromptQualityScore Batch Scoring is a paid API for AI agents from promptqualityscore.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Scores up to 10 prompts in a single batch request using an 8-dimensional quality rubric across multiple frameworks

## Facts

- Endpoint: GET https://promptqualityscore.com/api/score/batch
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/promptqualityscore-com-7206fd13
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vjFJwQeSnQeUTYtRQqhxa

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 promptqualityscore-com-7206fd13
```

Example prompt: Can you batch-score these 5 prompts using PQS and give me the 8-dimensional quality breakdown and grades for each one so I know which to use before sending them to GPT-4?

## When to prefer this

Use this endpoint when you need to evaluate multiple prompts (up to 10) in a single API call to save on per-call costs and reduce latency compared to scoring each prompt individually. Ideal for prompt optimization pipelines, A/B testing prompt variants, or pre-flight quality checks before dispatching to expensive LLM endpoints.

## Known failure modes

- More than 10 prompts submitted — batch limit exceeded
- Empty prompt array — no prompts to score
- Malformed request body — invalid JSON or missing required fields
- Payment failure — $0.25 USDC x402 payment not completed
- Rate limiting — too many requests in a short period
- Individual prompt too long — token or character limit exceeded

## 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 quality scores and grades (A-F) for each submitted prompt, including 8-dimensional quality breakdowns across multiple frameworks (such as PEEM) and sub-scores, allowing comparison and ranking of all prompts in the batch.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "prompts": {
   "type": "array",
   "items": {
    "oneOf": [
     {
      "type": "string",
      "maxLength": 10000,
      "minLength": 1
     },
     {
      "type": "object",
      "required": [
       "prompt"
      ],
      "properties": {
       "prompt": {
        "type": "string",
        "maxLength": 10000,
        "minLength": 1
       },
       "vertical": {
        "enum": [
         "software",
         "content",
         "business",
         "education",
         "science",
         "crypto",
         "general",
         "research"
        ],
        "type": "string"
       }
      }
     }
    ]
   },
   "maxItems": 10,
   "minItems": 1,
   "description": "Array of 1-10 prompts. Each item is a string or {prompt, vertical} object."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "results": [
   {
    "grade": "C",
    "score": 46,
    "out_of": 80,
    "prompt": "Explain PQS scoring in one sentence to an AI agent operator.",
    "vertical": "general",
    "top_fixes": [
     "Specify the exact output format you want (bullets, JSON, prose).",
     "Name the target reader or persona explicitly.",
     "Add one concrete example of the ideal response."
    ],
    "dimensions": {
     "total": 46,
     "clarity": 7,
     "context": 6,
     "examples": 4,
     "constraints": 5,
     "specificity": 6,
     "cot_structure": 6,
     "output_format": 7,
     "role_definition": 5
    }
   },
   {
    "grade": "D",
    "score": 39,
    "out_of": 80,
    "prompt": "Summarize this trade: BTC 0.4 at 63100.",
    "vertical": "crypto",
    "top_fixes": [
     "State the output format (one-liner, table, or bullet list).",
     "Name the audience (trader, PM, retail investor).",
     "Add the desired depth (one sentence, one paragraph, or analysis)."
    ],
    "dimensions": {
     "total": 39,
     "clarity": 6,
     "context": 4,
     "examples": 4,
     "constraints": 5,
     "specificity": 4,
     "cot_structure": 6,
     "output_format": 7,
     "role_definition": 5
    }
   }
  ],
  "summary": {
   "avg_score": 42.5,
   "avg_out_of": 80,
   "lowest_grade": "D",
   "lowest_score": 39,
   "total_scored": 2,
   "highest_score": 46
  },
  "batch_size": 2,
  "powered_by": "PQS - promptqualityscore.com",
  "pqs_version": "2.0"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/promptqualityscore-com-7206fd13/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)