New

Random Cards, Sets & Releases

Random catalog picks — simulate pack openings, discover new products, and seed recommendation carousels

What This Does

Returns random cards, sets, or releases matching your filters
On random cards, toggle includeParallels to roll weighted parallel odds (numbered rolls boost rarest first, then unlimited)
Parallel pulls come back with isParallel: true plus parallelId, parallelName, and numberedTo when applicable
Filter random cards by setId, releaseId (mutually exclusive), year, manufacturerId, or player name
Filter random sets and releases by year, manufacturer, and segment

When To Use This

Building a pack-opening simulator or card-of-the-day feature
Seeding recommendation carousels with fresh picks every render
Discovering unfamiliar releases or sets for exploration screens
Generating sample cards to showcase a player, year, or manufacturer
Any time you want "random matching" results instead of paginated sorted results

Real Example

Scenario

You open a 10-card pack from 2023 Topps Chrome Baseball — most will be base cards, but parallel odds may produce a Gold Refractor /50

Sample Request

GET

/v1/catalog/cards/random?setId=550e8400-e29b-41d4-a716-446655440003&count=10&includeParallels=true

What You Get Back

{
  "cards": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440010",
      "releaseId": "550e8400-e29b-41d4-a716-446655440001",
      "setId": "550e8400-e29b-41d4-a716-446655440003",
      "name": "Shohei Ohtani",
      "number": "1",
      "setName": "Base Set",
      "releaseName": "2023 Topps Chrome Baseball",
      "releaseYear": "2023"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440011",
      "releaseId": "550e8400-e29b-41d4-a716-446655440001",
      "setId": "550e8400-e29b-41d4-a716-446655440003",
      "name": "Mike Trout",
      "number": "27",
      "setName": "Base Set",
      "releaseName": "2023 Topps Chrome Baseball",
      "releaseYear": "2023",
      "isParallel": true,
      "parallelId": "550e8400-e29b-41d4-a716-446655440099",
      "parallelName": "Gold Refractor",
      "numberedTo": 50
    }
  ],
  "count": 10
}