Packs

Sealed Pack Assessment

The assessment resource returned for sealed trading-card products.

A sealed pack assessment identifies one sealed trading-card product from one photo: a pack, box, case, tin, collection or other sealed product. It returns the product's release, its name, its packaging and a confidence as the items entry.

Access

Sealed pack assessment is included with card identity: an organization with card identity enabled can call this endpoint, and there is nothing else to enable. Without card identity, the request is refused with a 403.

Image guidance

Submit exactly one photo per assessment, showing one sealed product. The front of the packaging, with its logo and product name in view, identifies it best. The product does not need to be upright or fill the frame: it is found in the photo and turned upright before it is identified.

A request with no photo or more than one is refused with a 400. When the photo cannot be read, downloaded or found, or shows nothing that can be identified, the assessment is rejected: assessment is null and issues says why.

Assessment sections

SectionDescription
identityThe release, product name, packaging, pack count and a confidence.

identity is the only section, so include can be omitted.

Identity fields

FieldMeaning
releaseThe release: one set's sealed print run, such as 1982 Topps Football.
nameThe release and its configuration, such as 1982 Topps Football Wax Pack.
yearThe release year, or a season such as 2024-25.
sport_or_gameThe sport or game, such as Baseball, Pokemon or Magic: The Gathering.
manufacturerThe release's manufacturer, such as Topps.
brandThe release's brand.
languageThe release's language.
familyThe kind of packaging: pack, multi_pack, box, collection, deck, tin, set or other.
configurationThe product's configuration, such as hobby_box, blaster_box, booster_pack or elite_trainer_box. See below.
containerunit, case, lot or display.
pack_countPacks in the item, binned: 1, 2-4, 5-9, 10-19, 20-39, 40-99, 100-299 or 300+.
confidenceThe probability, from 0 to 1, that the release and the configuration are both right. See below.

Fields with no value are omitted.

Family and configuration

family and pack_count are read from the photo itself, so they stay right for a product our catalog does not list. A pack counts as 1, a box as its packs, and a case as its boxes times their packs.

configuration names the exact product. When the closest catalog product's configuration does not match the packaging in the photo, configuration is omitted, and name ends in the family instead, as in 1982 Topps Football Pack. A case's name ends in Case, as in 2023 Topps Chrome Baseball Hobby Box Case.

Confidence

confidence is the probability that both the release and the configuration are right. When configuration is omitted, it is the probability for the release alone.

Example

{
  "assessment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "external_id": "pack-123",
  "status": "completed",
  "created_at": "2026-06-09T19:12:42.548Z",
  "completed_at": "2026-06-09T19:13:12.548Z",
  "assessment": {
    "items": [
      {
        "identity": {
          "release": "1982 Topps Football",
          "name": "1982 Topps Football Wax Pack",
          "year": "1982",
          "sport_or_game": "Football",
          "manufacturer": "Topps",
          "brand": "topps",
          "family": "pack",
          "configuration": "wax_pack",
          "container": "unit",
          "pack_count": "1",
          "confidence": 0.7084
        }
      }
    ]
  },
  "issues": []
}

Response structure

FieldMeaning
assessment.itemsThe identified product, one item.
issuesResponse-level limitations or rejection reasons.
model_versionThe release of our models that produced the assessment.

Check status and the top-level issues before using a result. A rejected response has no assessment, and issues explains why. A completed response can carry an issue that did not prevent the identification, such as a low-confidence match.

Resource

Full sealed pack assessment responses use this schema:

assessment_id*uuid

Unique Vardera assessment ID.

external_id?string

Caller-provided ID, if supplied.

status*enum

Final assessment outcome.

Value in"completed" | "partial" | "rejected"
created_at*timestamp

RFC 3339 timestamp for when Vardera created the assessment.

FormatRFC 3339 timestamp
completed_at?timestamp

RFC 3339 timestamp for when processing finished, regardless of outcome.

FormatRFC 3339 timestamp
assessment?object | null

Sealed product assessment details grouped by requested section.

issues?array<string>

Human-readable limitations or rejection reasons, such as an uncertain match.

model_version?string

The release of Vardera's models that produced this assessment. Store it with the result to trace the answer to the models, thresholds and settings behind it.

Show example
{
  "assessment": {
    "items": [
      {
        "identity": {
          "brand": "topps",
          "confidence": 0.7084,
          "configuration": "wax_pack",
          "container": "unit",
          "family": "pack",
          "manufacturer": "Topps",
          "name": "1982 Topps Football Wax Pack",
          "pack_count": "1",
          "release": "1982 Topps Football",
          "sport_or_game": "Football",
          "year": "1982"
        }
      }
    ]
  },
  "assessment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "completed_at": "2026-06-09T19:13:12.548Z",
  "created_at": "2026-06-09T19:12:42.548Z",
  "external_id": "pack-123",
  "issues": [],
  "model_version": "packs-3f9a1c2",
  "status": "completed"
}