Universal grade map

curl --request GET \
  --url https://api.gemrate.com/v1/grades \
  --header 'x-api-key: <api-key>'

{
  "data": {
    "version": "4c9c5359f8e4",
    "graders": [
      "psa",
      "beckett",
      "sgc",
      "cgc"
    ],
    "grades": [
      {
        "universal": "gem_mint",
        "label": "Gem Mint",
        "by_grader": {
          "psa": "10",
          "beckett": "9.5",
          "sgc": "10",
          "cgc": "10"
        },
        "abbr": "10",
        "gem_tier": true
      }
    ],
    "qualifiers": [
      {
        "universal": "gem_mint",
        "label": "Gem Mint",
        "by_grader": {
          "psa": "10",
          "beckett": "9.5",
          "sgc": "10",
          "cgc": "10"
        },
        "abbr": "10",
        "gem_tier": true
      }
    ],
    "description": "<string>"
  },
  "meta": {
    "request_id": "req_abc123",
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 1340,
      "total_pages": 14,
      "next_page": 2
    }
  }
}

Grades

Universal grade map

The full universal grade map: every universal grade with each grading company’s own label for it (null = the grader doesn’t issue that grade), plus the PSA-only qualifier axis. This is reference data — the same scale all population and grade values in the API are reported on (see Universal grades).

The response is also published as static files you can download directly: universal-grades.json and universal-grades.csv. version is a content hash, so it changes only when the map itself changes.

GET

grades

Universal grade map

curl --request GET \
  --url https://api.gemrate.com/v1/grades \
  --header 'x-api-key: <api-key>'

{
  "data": {
    "version": "4c9c5359f8e4",
    "graders": [
      "psa",
      "beckett",
      "sgc",
      "cgc"
    ],
    "grades": [
      {
        "universal": "gem_mint",
        "label": "Gem Mint",
        "by_grader": {
          "psa": "10",
          "beckett": "9.5",
          "sgc": "10",
          "cgc": "10"
        },
        "abbr": "10",
        "gem_tier": true
      }
    ],
    "qualifiers": [
      {
        "universal": "gem_mint",
        "label": "Gem Mint",
        "by_grader": {
          "psa": "10",
          "beckett": "9.5",
          "sgc": "10",
          "cgc": "10"
        },
        "abbr": "10",
        "gem_tier": true
      }
    ],
    "description": "<string>"
  },
  "meta": {
    "request_id": "req_abc123",
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 1340,
      "total_pages": 14,
      "next_page": 2
    }
  }
}

Authorizations

x-api-key

string

header

required

Response

The universal grade map.

data

object

The universal grade scale and each grader's labels for it.

Show child attributes