---
title: "Batch PQS scoring, up to 10 prompts ($0.25 USDC)"
method: POST
path: "/api/score/batch"
tags: ["batch", "paid", "evm"]
---

# Batch PQS scoring, up to 10 prompts ($0.25 USDC)

`POST /api/score/batch`

## Request

- Base URL: `https://promptqualityscore.com`
- URL: `https://promptqualityscore.com/api/score/batch`
- Auth: one of:
  - API key in header `X-PAYMENT`
  - API key in header `Authorization`

Batch PQS scoring. Score up to 10 prompts in a single call.

## Request body

- object
  - `prompts` union[], required: Array of 1-10 prompts. Each item is a string or {prompt, vertical} object.
    - union
      - string
      - object
        - `prompt` string, required
        - `vertical` 'software' | 'content' | 'business' | 'education' | 'science' | 'crypto' | 'general' | 'research'

## Response `200`

Scoring result

- object
  - `pqs_version` '2.0', required
  - `batch_size` integer
  - `results` object[], required
    - `prompt` string
    - `vertical` string
    - `score` integer
    - `out_of` 80
    - `grade` string
    - `dimensions` object
      - `clarity` integer
      - `specificity` integer
      - `context` integer
      - `constraints` integer
      - `output_format` integer
      - `role_definition` integer
      - `examples` integer
      - `cot_structure` integer
      - `total` integer
    - `top_fixes` string[]
    - `error` string: present instead of score fields if this row failed
  - `summary` object, required
    - `total_scored` integer
    - `avg_score` number
    - `avg_out_of` 80
    - `lowest_grade` string
    - `highest_score` integer
    - `lowest_score` integer
  - `powered_by` string

## Other responses

- `400`: Invalid request body
- `401`: Invalid or missing bearer API key (when using bearer auth)
- `402`: Payment Required - x402 challenge when no bearer API key present. See x-payment-info.

---

[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)