Population Reports

Graded population counts by card, set, or release from PSA, BGS, CGC, SGC, and TAG

What This Does

Returns graded population counts for a single card, set, or release
Breaks card populations into base + parallel variants
Reports both unqualified (population) and qualified (qualified_population) counts per grade
For releases, includes both release-wide rollups and per-set breakdowns
Supports filtering to a single grading company via grading_company_id

When To Use This

Showing graded scarcity alongside a card or set page
Comparing grading-company coverage for a release
Highlighting "rare in PSA 10" or similar callouts
Auditing how many examples of a card have been graded across companies

Real Example

Scenario

You look up the graded population for a specific card

Sample Request

GET

/v1/population/card/{card_id}

What You Get Back

{
  "card_id": "550e8400-e29b-41d4-a716-446655440000",
  "card_name": "Ken Griffey Jr. — 1989 Upper Deck #1",
  "total_population": 12340,
  "base": {
    "total_population": 11200,
    "grading_companies": [
      {
        "id": "550e8400-e29b-41d4-a716-4466554400ff",
        "name": "PSA",
        "last_synced_at": "2026-04-30T14:22:09Z",
        "total_population": 9800,
        "grading_types": [
          {
            "id": "550e8400-e29b-41d4-a716-446655441111",
            "name": "Standard",
            "total_population": 9800,
            "grades": [
              {
                "id": "550e8400-e29b-41d4-a716-446655442222",
                "grade": "10",
                "population": 412,
                "qualified_population": 7
              }
            ]
          }
        ]
      }
    ]
  },
  "parallels": [
    {
      "parallel_id": "550e8400-e29b-41d4-a716-446655443333",
      "parallel_name": "Refractor",
      "total_population": 1140,
      "grading_companies": []
    }
  ]
}