Assessment Basics

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 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 is
• grade — the item's condition or grade, with subgrades where the category provides them
• valuation — an estimated value

By default, the API assesses and returns all available sections. To request only identity, for example, send:

{
  "include": ["identity"]
}

The response then contains only what you requested. Limiting the request can be faster in some cases.

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 a particular item. Refer to the category-specific assessment guide for 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": {
    "items": [
      {
        "identity": { "name": "1921-D Morgan Silver Dollar", "confidence": 0.93 },
        "grade": { "grade": "MS-63", "confidence": 0.81 },
        "valuation": { "price": 85.0 }
      },
      {
        "identity": { "name": "1909 Lincoln Cent", "confidence": 0.88 },
        "grade": { "grade": "AU-50", "confidence": 0.74 },
        "valuation": { "price": 20.0 }
      }
    ]
  },
  "issues": []
}

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:

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.

Every assessment outcome returns HTTP 200. Errors that prevent the API from accepting or running an assessment use an HTTP error status instead.

Valuation

For each item, valuation.price is the primary estimate when Vardera can produce one. Some categories also return price_range with min and max values, and coin valuations can include melt_value when applicable.

Treat valuation fields as estimates derived from available item information and comparable market data. Missing valuation fields mean the API did not return that estimate for the assessment.

Confidence

Some sections 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.

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.