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
| Section | Description |
|---|---|
identity | The release, product name, packaging, pack count and a confidence. |
identity is the only section, so include can be omitted.
Identity fields
| Field | Meaning |
|---|---|
release | The release: one set's sealed print run, such as 1982 Topps Football. |
name | The release and its configuration, such as 1982 Topps Football Wax Pack. |
year | The release year, or a season such as 2024-25. |
sport_or_game | The sport or game, such as Baseball, Pokemon or Magic: The Gathering. |
manufacturer | The release's manufacturer, such as Topps. |
brand | The release's brand. |
language | The release's language. |
family | The kind of packaging: pack, multi_pack, box, collection, deck, tin, set or other. |
configuration | The product's configuration, such as hobby_box, blaster_box, booster_pack or elite_trainer_box. See below. |
container | unit, case, lot or display. |
pack_count | Packs in the item, binned: 1, 2-4, 5-9, 10-19, 20-39, 40-99, 100-299 or 300+. |
confidence | The 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
| Field | Meaning |
|---|---|
assessment.items | The identified product, one item. |
issues | Response-level limitations or rejection reasons. |
model_version | The 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*uuidUnique Vardera assessment ID.
external_id?stringCaller-provided ID, if supplied.
status*enumFinal assessment outcome.
"completed" | "partial" | "rejected"created_at*timestampRFC 3339 timestamp for when Vardera created the assessment.
RFC 3339 timestampcompleted_at?timestampRFC 3339 timestamp for when processing finished, regardless of outcome.
RFC 3339 timestampassessment?object | nullSealed product assessment details grouped by requested section.
issues?array<string>Human-readable limitations or rejection reasons, such as an uncertain match.
model_version?stringThe 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"
}