---
title: "Grade known centering ratios"
method: POST
path: "/v1/centering/grade"
tags: ["centering"]
---

# Grade known centering ratios

`POST /v1/centering/grade`

## Request

- Base URL: `https://api.pokemontcgapi.com`
- URL: `https://api.pokemontcgapi.com/v1/centering/grade`
- Auth: API key in header `X-Api-Key`

Maximum grades from known centering ratios for PSA, BGS, CGC and SGC.

## Request body

- union: At least one known ratio. Do not mix nested and corresponding flat fields. Pairs must sum to 100 or 1; an axis suffix must match its field.
  - object
    - `front_lr` union, required
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `front` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'
  - object
    - `front_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union, required
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `front` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'
  - object
    - `front_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union, required
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `front` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'
  - object
    - `front_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union, required
      - string
      - union[]
        - union
          - number
          - string
    - `front` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'
  - object
    - `front_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `front` union, required
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'
  - object
    - `front_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `front_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_lr` union
      - string
      - union[]
        - union
          - number
          - string
    - `back_tb` union
      - string
      - union[]
        - union
          - number
          - string
    - `front` union
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `back` union, required
      - object
        - `lr` union, required
          - string
          - union[]
            - union
              - …
        - `tb` union
          - string
          - union[]
            - union
              - …
      - object
        - `lr` union
          - string
          - union[]
            - union
              - …
        - `tb` union, required
          - string
          - union[]
            - union
              - …
    - `house` 'PSA' | 'BGS' | 'CGC' | 'SGC'

## Response `200`

Success

- object
  - `data` object, required
    - `front` object, nullable, required
      - `ratios` object, required
        - `lr` number, nullable, required
        - `tb` number, nullable, required
      - `missing_axes` string[], required
      - `ceilings` object, required
        - `PSA` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `BGS` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `CGC` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `SGC` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
    - `back` object, nullable, required
      - `ratios` object, required
        - `lr` number, nullable, required
        - `tb` number, nullable, required
      - `missing_axes` string[], required
      - `ceilings` object, required
        - `PSA` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `BGS` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `CGC` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
        - `SGC` object
          - `maximum_grade` number, nullable, required
          - `label` string, nullable, required
          - `rank` number, nullable, required
          - `limiting_face` 'front' | 'back', required
          - `limiting_axis` 'lr' | 'tb', required
          - `distance_to_next` number, nullable, required
          - `next_grade` number, nullable, required
          - `next_label` string, nullable, required
          - `borderline` boolean, required
          - `unconstrained` boolean, required
          - `source_status` 'official' | 'interpreted' | 'approximate', required
          - `standard_status` 'official' | 'interpreted' | 'approximate', required
          - `source` string, required
          - `sources` string[], required
          - `reviewed_at` string, required
          - `verification` string, required
    - `combined` object, required
      - `PSA` object
        - `maximum_grade` number, nullable, required
        - `label` string, nullable, required
        - `rank` number, nullable, required
        - `limiting_face` 'front' | 'back', required
        - `limiting_axis` 'lr' | 'tb', required
        - `distance_to_next` number, nullable, required
        - `next_grade` number, nullable, required
        - `next_label` string, nullable, required
        - `borderline` boolean, required
        - `unconstrained` boolean, required
        - `source_status` 'official' | 'interpreted' | 'approximate', required
        - `standard_status` 'official' | 'interpreted' | 'approximate', required
        - `source` string, required
        - `sources` string[], required
        - `reviewed_at` string, required
        - `verification` string, required
      - `BGS` object
        - `maximum_grade` number, nullable, required
        - `label` string, nullable, required
        - `rank` number, nullable, required
        - `limiting_face` 'front' | 'back', required
        - `limiting_axis` 'lr' | 'tb', required
        - `distance_to_next` number, nullable, required
        - `next_grade` number, nullable, required
        - `next_label` string, nullable, required
        - `borderline` boolean, required
        - `unconstrained` boolean, required
        - `source_status` 'official' | 'interpreted' | 'approximate', required
        - `standard_status` 'official' | 'interpreted' | 'approximate', required
        - `source` string, required
        - `sources` string[], required
        - `reviewed_at` string, required
        - `verification` string, required
      - `CGC` object
        - `maximum_grade` number, nullable, required
        - `label` string, nullable, required
        - `rank` number, nullable, required
        - `limiting_face` 'front' | 'back', required
        - `limiting_axis` 'lr' | 'tb', required
        - `distance_to_next` number, nullable, required
        - `next_grade` number, nullable, required
        - `next_label` string, nullable, required
        - `borderline` boolean, required
        - `unconstrained` boolean, required
        - `source_status` 'official' | 'interpreted' | 'approximate', required
        - `standard_status` 'official' | 'interpreted' | 'approximate', required
        - `source` string, required
        - `sources` string[], required
        - `reviewed_at` string, required
        - `verification` string, required
      - `SGC` object
        - `maximum_grade` number, nullable, required
        - `label` string, nullable, required
        - `rank` number, nullable, required
        - `limiting_face` 'front' | 'back', required
        - `limiting_axis` 'lr' | 'tb', required
        - `distance_to_next` number, nullable, required
        - `next_grade` number, nullable, required
        - `next_label` string, nullable, required
        - `borderline` boolean, required
        - `unconstrained` boolean, required
        - `source_status` 'official' | 'interpreted' | 'approximate', required
        - `standard_status` 'official' | 'interpreted' | 'approximate', required
        - `source` string, required
        - `sources` string[], required
        - `reviewed_at` string, required
        - `verification` string, required
    - `normalizations` object[], required
      - `field` string, required
      - `input` union
        - number
        - string
      - `ratio` string
      - `note` string, required
    - `incomplete` boolean, required
    - `missing_faces` string[], required
    - `summary` string, required
    - `disclaimer` string, required
  - `meta` object, required
    - `elapsed_ms` number, required
    - `engine_version` string, required

## Other responses

- `400`: INVALID_PARAMETER
- `401`: MISSING_API_KEY
- `403`: PLAN_REQUIRED, TRIAL_EXPIRED
- `413`: PAYLOAD_TOO_LARGE
- `415`: UNSUPPORTED_MEDIA_TYPE
- `429`: QUOTA_EXCEEDED
- `503`: FEATURE_NOT_CONFIGURED

---

[API](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api.md) · [All operations](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pokemontcgapi/apis/pokemon-tcg-api/revisions/9e4ee9a375da?raw)