Free

Collection Set Completion Progress

Track progress toward completing card sets

What This Does

Shows completion percentage per set
Lists missing card UUIDs (for sets ≥85% complete)
Calculates estimated cost to complete each set
Provides summary statistics across all sets
Tracks difficulty scores based on card availability

When To Use This

Completing specific card sets
Finding gaps in your collection
Planning card purchases
Tracking set building goals
Prioritizing which sets to complete first

Real Example

Scenario

You check progress on completing 2023 Topps Chrome

Sample Request

GET

/v1/collection/{collectionId}/set-progress?sortBy=completion&order=desc

What You Get Back

{
  "summary": {
    "totalSets": 12,
    "nearCompleteSets": 3,
    "fullyCompleteSets": 1,
    "totalEstimatedCost": "485.00"
  },
  "sets": [
    {
      "setId": "550e8400-e29b-41d4-a716-446655440001",
      "setName": "Base Set",
      "releaseName": "2023 Topps Chrome",
      "releaseYear": "2023",
      "totalCards": 220,
      "ownedCards": 215,
      "missingCards": [
        "550e8400-e29b-41d4-a716-446655440010",
        "550e8400-e29b-41d4-a716-446655440011"
      ],
      "completionPercentage": 97.7,
      "estimatedCostToComplete": "45.00",
      "difficultyScore": 25,
      "averageCardValue": "2.50"
    }
  ],
  "total_count": 12,
  "skip": 0,
  "take": 20
}