Toy Assessment
The assessment resource returned for collectible toy workflows.
A toy assessment identifies a collectible toy and returns valuation details when requested.
Image guidance
Include the item clearly and add packaging, model numbers, manufacturer marks, accessories, or condition details when they help identify the exact collectible.
Assessment sections
Toy assessments support these result sections. If your integration only needs some sections, pass include with the sections you want; requesting fewer sections can be faster in some cases.
| Section | Description |
|---|---|
identity | Toy name, brand, manufacturer, franchise, line, or year. |
valuation | Estimated price and price range when available. |
Resource
Full toy 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?objectToy assessment details grouped by requested section.
Show child attributes1 field
assessment.items?array<object>Show child attributes2 fields
assessment.items[].identity?objectToy identity fields returned by toy assessment endpoints.
Show child attributes9 fields
assessment.items[].identity.name?stringassessment.items[].identity.character?stringassessment.items[].identity.year?stringassessment.items[].identity.brand?stringassessment.items[].identity.manufacturer?stringassessment.items[].identity.franchise?stringassessment.items[].identity.toy_line?stringassessment.items[].identity.series?stringassessment.items[].identity.toy_sub_type?enumSub-category of toy for routing to specialized paths.
"action_figure" | "doll" | "vehicle" | "model_kit" | "board_game" | "general"assessment.items[].valuation?objectValuation fields returned by toy assessment endpoints.
Show child attributes3 fields
assessment.items[].valuation.price?numberassessment.items[].valuation.price_range?objectToy valuation price interval.
Show child attributes2 fields
assessment.items[].valuation.price_range.min?numberassessment.items[].valuation.price_range.max?numberassessment.items[].valuation.confidence?stringissues?array<string>Human-readable limitations or rejection reasons.
Show example
{
"assessment": {
"items": [
{
"identity": {
"brand": "Transformers",
"character": "Optimus Prime",
"franchise": "Transformers",
"manufacturer": "Hasbro",
"name": "Optimus Prime",
"series": "Autobot Cars",
"toy_line": "Generation 1",
"toy_sub_type": "action_figure",
"year": "1984"
},
"valuation": {
"confidence": "high",
"price": 120,
"price_range": {
"max": 150,
"min": 90
}
}
}
]
},
"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": "toy-123",
"issues": [],
"status": "completed"
}