> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gemrate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Grades

> How grades are reported — each grader's own label keys — and the grade map that ties them together.

Every grading company uses its own grade names and notation for what is often the
same level of quality — and some issue grades others don't (half-points,
qualifiers, Pristine/Perfect tens). The GemRate API reports **all** population and
grade data under each grader's **own label keys**, so the keys you read back match
the grader you're looking at.

A label key is `{grader}_{grade}` — e.g. `psa_10`, `beckett_9_5`, `cgc_10_perfect`,
`sgc_10_pristine`, qualifiers `psa_q1`…`psa_q9`. Decimals become underscores
(`8.5` → `8_5`) and the top of scale carries an explicit tier segment
(`10_pristine`, `10_perfect`, `10_black`). Every `grades`/`qualifiers` object in a
response — on `by_grader`, on history points, and on the cert `grade` field — is
keyed this way.

## The grade map

Grades fall on two axes:

* **The main ladder** — Auth Altered, Auth, 1…9 (whole + half steps), Mint+ (9.5),
  Gem Mint (10), Pristine, Perfect. This is what almost everything is keyed by.
* **A PSA-only qualifier axis** — `psa_q1`…`psa_q9` plus `psa_q1_5`. These are PSA
  grades that carry a qualifier (e.g. OC, ST, MK). No other grader issues them, so
  this axis is `null`/absent for Beckett, SGC, and CGC.

The three top tiers — Gem Mint, Pristine, and Perfect — are the **gem tiers**:
they're what each grader's `gem_total` / `gem_rate` count. A grader's `gem_total`
is the sum of exactly the label keys below; `gem_rate` is that sum over the grader's
`total`. Note each grader gems from its Gem Mint (10) up, so the exact keys differ:

| Grader  | Gem label keys                                           |
| ------- | -------------------------------------------------------- |
| PSA     | `psa_10`                                                 |
| Beckett | `beckett_9_5`, `beckett_10_pristine`, `beckett_10_black` |
| SGC     | `sgc_10`, `sgc_10_pristine`                              |
| CGC     | `cgc_10`, `cgc_10_pristine`, `cgc_10_perfect`            |

## Each grader's grades and label keys

Each grader reports under its **own** grade labels and label keys. The tables below
list every grade a grader issues — its display label and the label key you read back
in a response. (The `1.5 … 8.5` half grades follow the same pattern as the whole
grades and are elided for brevity.)

### PSA

| Grade         | Label key                             |
| ------------- | ------------------------------------- |
| Auth          | `psa_auth`                            |
| 1, 1.5, 2 … 9 | `psa_1`, `psa_1_5`, `psa_2` … `psa_9` |
| 10            | `psa_10`                              |

PSA qualifier axis:

| Grade             | Label key                                 |
| ----------------- | ----------------------------------------- |
| Q1, Q1.5, Q2 … Q9 | `psa_q1`, `psa_q1_5`, `psa_q2` … `psa_q9` |

### Beckett

| Grade         | Label key                                             |
| ------------- | ----------------------------------------------------- |
| 0             | `beckett_0`                                           |
| 1, 1.5, 2 … 9 | `beckett_1`, `beckett_1_5`, `beckett_2` … `beckett_9` |
| 9.5           | `beckett_9_5`                                         |
| 10 Pristine   | `beckett_10_pristine`                                 |
| 10 Black      | `beckett_10_black`                                    |

### SGC

| Grade         | Label key                             |
| ------------- | ------------------------------------- |
| Auth          | `sgc_auth`                            |
| 1, 1.5, 2 … 9 | `sgc_1`, `sgc_1_5`, `sgc_2` … `sgc_9` |
| 9.5           | `sgc_9_5`                             |
| 10            | `sgc_10`                              |
| 10 Pristine   | `sgc_10_pristine`                     |

### CGC

| Grade             | Label key                             |
| ----------------- | ------------------------------------- |
| Authentic Altered | `cgc_auth_altered`                    |
| Authentic         | `cgc_auth`                            |
| 1, 1.5, 2 … 9     | `cgc_1`, `cgc_1_5`, `cgc_2` … `cgc_9` |
| 9.5               | `cgc_9_5`                             |
| 10                | `cgc_10`                              |
| 10 Pristine       | `cgc_10_pristine`                     |
| 10 Perfect        | `cgc_10_perfect`                      |

## Download the full map

The complete map — every grade with each grader's label key (`grader_labels`),
display name (`grader_names`), and the PSA qualifier axis — is available to download
as a JSON file, or to fetch live from the API.

<a
  href="https://www.gemrate.com/static/gemrate-grades.csv"
  download
  style={{
display: "inline-flex",
alignItems: "center",
gap: "0.5rem",
padding: "0.75rem 1.5rem",
fontWeight: 600,
color: "#fff",
background: "#2563eb",
borderRadius: "0.5rem",
textDecoration: "none",
}}
>
  <Icon icon="download" color="#fff" /> Download CSV
</a>