New

Release Calendar

Upcoming and recent card product releases with street dates and pre-order windows

What This Does

Lists release calendar entries sorted by release date (newest first)
Filters by segment, manufacturer, and year — all accept UUIDs or case-insensitive names
Returns each entry with release_date and pre_order_date when available
Links each entry to its segment_id and manufacturer_id for follow-up lookups
Supports pagination via take and skip for large result windows

When To Use This

Building a "coming soon" or "recently released" feed
Alerting collectors when pre-orders open for a favorite manufacturer
Populating a release-day countdown or roadmap view
Filtering releases to a specific segment (e.g. Basketball) or year window
Surfacing new-product discovery in marketing pages

Real Example

Scenario

You browse upcoming 2026 Panini releases to plan pre-orders

Sample Request

GET

/v1/release-calendar/?manufacturer=Panini&year=2026&take=20

What You Get Back

{
  "release_calendar": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "2026 Panini Prizm Basketball",
      "year": "2026",
      "release_date": "2026-11-12",
      "pre_order_date": "2026-08-01",
      "segment_id": "660e8400-e29b-41d4-a716-446655440001",
      "manufacturer_id": "770e8400-e29b-41d4-a716-446655440002"
    }
  ],
  "total_count": 42,
  "skip": 0,
  "take": 20
}