Assessment Basics
Understand assessment endpoints, sections, responses, and status.
An assessment identifies a collectible and returns category-specific information, such as its grade or estimated value. The available fields vary by category.
What item do you want to assess?
Choose the category that matches the collectible you want to assess, then use its endpoint. The sections below explain the request options and response shapes they share.
Choose: Assess Coin, Assess Banknote, Assess Card, or Assess Toy.
What should the assessment include?
Use include to specify what Vardera should assess. Depending on the category and the operations enabled for your organization, you can request:
identity: what the item isgrade: the item's condition or grade, with subgrades where the category provides themvaluation: an estimated value
When you omit include, the assessment returns every section your organization has enabled for that category. To request only identity, for example, send:
{
"include": ["identity"]
}The response then contains only what you requested, and a shorter list can be faster. What happens when you list a section your organization does not have enabled depends on the category; see Errors.
How to read the response
Every assessment response identifies the assessment, reports its outcome, and contains the requested category-specific results. Successfully assessed collectibles appear in assessment.items, while the top-level issues field explains any known limitations.
Depending on the category, assessment can also contain properties that describe the assessment as a whole rather than one item, such as a coin assessment's presentation. Each category's assessment page has its complete response structure.
{
"assessment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"external_id": "coin-123",
"status": "completed",
"created_at": "2026-06-09T19:12:42.548Z",
"completed_at": "2026-06-09T19:13:12.548Z",
"assessment": {
"presentation": "individual",
"items": [
{
"identity": { "name": "1921-D Morgan Silver Dollar", "confidence": 0.93 },
"grade": { "grade": "MS-63", "condition": "Mint State", "confidence": 0.81 }
}
]
},
"issues": [],
"model_version": "coins-3f9a1c2"
}Each object in assessment.items represents one successfully assessed collectible. Its identity, grade, and valuation properties correspond to what you requested with include. Fields that were not requested or could not be determined are omitted.
Status
Check status before using the assessment result:
| Status | Meaning |
|---|---|
completed | Every submitted image was processed and every detected item was assessed. |
partial | At least one item was assessed, but a submitted image or detected item was skipped. |
rejected | No assessment could be produced; assessment is null. |
issues is an array of human-readable messages. For a partial response, it explains what was skipped and why. For a completed response, it can describe limitations that did not require skipping an image or item. For a rejected response, it explains why Vardera could not produce an assessment.
model_version names the release of our models that produced the assessment. Store it with the result to trace the answer to that release. See Model releases.
Every assessment outcome returns HTTP 200. Errors that prevent the API from accepting or running an assessment use an HTTP error status instead.
Valuation
Valuation is available for toys. For each item, valuation.price is the estimate in US dollars when Vardera can produce one, with a price_range (min and max) and a confidence of high or low.
Valuations are estimates from comparable market data. A missing field means the API could not produce that estimate for this item.
Confidence
Identity and grade sections can carry a confidence from 0 to 1. It describes only the section it appears on: an identity confidence says how sure we are the item was identified correctly, and says nothing about the grade beside it. A toy valuation's confidence is high or low instead.
Confidence is scoped to the category that produced it, so compare values within a category rather than across them. Each category's assessment page lists the fields it returns.