---
title: "Quick pre-flight grade ($0.001 USDC). Composite + PEEM/RAGAS/G-Eval + verdict."
method: POST
path: "/api/pqs-grade"
tags: ["grade", "paid", "evm"]
---

# Quick pre-flight grade ($0.001 USDC). Composite + PEEM/RAGAS/G-Eval + verdict.

`POST /api/pqs-grade`

## Request

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

Quick pre-flight quality score: composite + three framework sub-scores (PEEM, RAGAS, G-Eval) + verdict. Designed to run upstream of any other paid call to filter weak prompts before inference.

## Request body

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

## Response `200`

Scoring result

- object
  - `score` integer, required: Composite 0-100 score (percentile-normalized total)
  - `grade` 'A' | 'B' | 'C' | 'D' | 'F', required
  - `verdict` string, required: Single sentence diagnosing the weakest dimension, with a framework citation
  - `frameworks` object, required
    - `peem` number, required: PEEM framework score: weights structure (clarity, output format, role, constraints)
    - `ragas` number, required: RAGAS framework score: weights grounding (context, specificity, examples)
    - `geval` number, required: G-Eval framework score: weights LLM-judged faithfulness (clarity, specificity, CoT, constraints)
  - `methodology_url` string: Link to the methodology blog post explaining the five-framework synthesis
  - `upgrade_url` string: Link to PQS Pro for the full 8-dimension SaaS

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