Skip to main content

Get the population report for a card

GET 
/v1/cards/:card_id/population-report

How many copies of this card each grading company has graded, per grade. Pro tier and above.

Companies. graders always carries all four keys — psa, bgs, cgc, sgc. A company that has graded no copies of the card is null, so read coverage from the data, not from which keys exist.

Grade labels. Every company reports the same fixed set of grade keys. Whole grades are g1 through g10; half grades append _5 (g8_5 is a grade of 8.5). authentic counts copies authenticated without a numeric grade, and authentic_altered copies deemed authentic but altered. Above a plain 10 sit the named premium grades: g10pristine (Pristine 10 — awarded by BGS, CGC, and SGC), g10black_label (BGS Black Label 10), and g10perfect (CGC Perfect 10). A grade a company doesn't award is simply always 0 — for example BGS issues no plain 10, its ladder goes 9.5 then Pristine/Black Label.

Values. Every grade key is a non-negative integer count of graded copies. total is the sum of the card's grade counts for that company. gems is the company's gem-grade count (e.g. PSA 10s) and gem_rate is the gem share as a fraction between 0 and 1; both can be null. Copies PSA graded with a qualifier (OC, MK, …) are not counted, so PSA's own published total can run slightly higher than total.

404 population_report_not_found means we have no population data for this card — the common case for low-value cards, which are rarely graded.

Request​

Responses​

Successful Response