Graded population

PSA, BGS, CGC and SGC population counts for every printing of a Pokémon card, grade by grade, with gem rate and the share graded higher.

Graded Population

GET/v1/cards/:id/population1 credit

How many copies of each printing PSA, BGS, CGC and SGC have graded, and at what grade. The counts come from the graders' own population reports, merged by GemRate, and refresh weekly. Pro and above; the Free plan gets 403.

There is one object per variant, named as in price rows ("Holofoil", "Reverse Holofoil", "1st Edition"). Variants that are one physical print carry the same counts. A card nobody has graded, or that we have not matched yet, returns an empty variants list rather than 404.

grades sums the graders' numeric grades, keyed "1" to "10" with halves as "8.5"; a grade nobody issued for the card is absent rather than zero. pristine (BGS, CGC and SGC 10 Pristine) and black_label (BGS Black Label, CGC Perfect 10) sit above a plain 10 and are not in grades. total_gems counts each grader's gem grade or better: PSA 10, BGS 9.5 and up, SGC and CGC 10 and up.

percent_higher gives, for each key in grades, the share of numerically graded copies that graded higher, Pristine and Black Label included. It is the usual input to a grading-ROI estimate: a raw copy that comes back a 9 or better has percent_higher["8.5"] odds.

graders carries each grader's own report, with its total, its grades, pop_report_url and, for PSA, spec_id. updated_at is when we last fetched the counts; last_population_change is the last day any grader's count moved.

Parameters

idstringrequired

The unique card ID.

variantstring

Only this variant, matched exactly as spelled in price rows, e.g. "Holofoil" or "Reverse Holofoil".

Try it

curl -H "X-API-Key: YOUR_API_KEY" \
  https://api.pkmnprices.com/v1/cards/{id}/population
Response
{
  "card_id": 18176,
  "variants": [
    {
      "variant": "Normal",
      "total_population": 3822,
      "total_gems": 854,
      "gem_rate": 22.34,
      "grades": { "7": 182, "8": 702, "8.5": 83, "9": 1715, "9.5": 104, "10": 791 },
      "pristine": 49,
      "black_label": 0,
      "authentic": 7,
      "percent_higher": { "7": 90.69, "8": 71.87, "8.5": 69.7, "9": 24.74, "9.5": 22.02, "10": 1.28 },
      "graders": {
        "PSA": {
          "total": 2819,
          "gems": 400,
          "gem_rate": 14.19,
          "grades": { "8": 654, "9": 1435, "10": 400 },
          "pristine": null,
          "black_label": null,
          "authentic": 0,
          "altered": null,
          "qualified": 0,
          "last_population_change": "2026-10-16",
          "pop_report_url": "https://www.psacard.com/pop/tcg-cards/2025/pokemon-m24-en-mcdonald-s-collection/292686",
          "spec_id": "12660863",
          "description": "2025 Pokemon M24 EN-Mcdonald's Collection Charizard Base 001"
        }
      },
      "last_population_change": "2026-10-18",
      "updated_at": "2026-10-20T21:00:00+00:00"
    }
  ]
}