Coin Assessment

A coin assessment identifies one or more coins visible in the submitted photos. It reports whether they appear as individual coins, a roll, or a pile, and returns one items entry for each coin it can assess. Each item can include grade details when requested and valuation estimates when available.

Image guidance

You can submit up to 20 photos of one coin or a group of coins. Include both obverse and reverse when possible. For groups, start with clear overview photos and keep the order and layout of the coins consistent across views; close-ups can help with dates, mint marks, varieties, and condition details.

Rolls and piles can include coins that are hidden, overlapping, or too small to assess individually. The response includes only coins that can be individually identified from the submitted photos; it does not assume that the remaining contents share the same identity, grade, or value.

For slabbed coins, include the label or certificate area if it is visible. Slab details are only supported for single-coin assessments. In multi-coin submissions containing slabs, visible coins may still be assessed, but label information is not read or associated with individual results. The response includes a human-readable top-level issue when this limitation applies.

Assessment sections

Coin 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.

Identity fields

Grade fields

The grade section uses one of two grading modes configured for your organization. Fields that do not apply are omitted.

Default grading

By default, raw coins return a specific grade and, when available, its grade_range.

A raw-coin response can include the model's lower and upper grade bounds:

{
  "grade": {
    "grade": "MS-63",
    "grade_range": ["MS-61", "MS-65"],
    "confidence": 0.81
  }
}

Bucket grading

With bucket grading, raw coins return condition instead of grade and grade_range. Slabbed coins still return the specific grade shown on the holder when available. grade and condition are never returned together.

A condition response returns one of four coarse values instead:

{
  "grade": {
    "condition": "Extremely Fine to About Uncirculated",
    "confidence": 0.81
  }
}

The possible condition values are Below Fine, Fine to Very Fine, Extremely Fine to About Uncirculated, and Uncirculated.

Grade and valuation sections can also include their own confidence values from 0 to 1. Grade confidence applies to whichever specific grade or condition was returned. Each confidence value can be omitted when an appropriate confidence signal is unavailable.

Response structure

A successful response can be partial when a submitted image cannot be processed or some visible coins cannot be assessed reliably. The API returns the useful results instead of discarding the entire submission.

Check the top-level issues before using a result. A partial response contains the coins that were assessed, while issues explains which images or detected coins were skipped and why. A completed response can also include an issue that did not prevent the coin assessment from finishing—for example, slab details that could not be read in a multi-coin submission.

For a roll or pile, identity, grade, and valuation fields apply only to the corresponding entries in assessment.items. A returned valuation is not an estimate of the complete roll or pile. The response includes an issue explaining that the other contents were not verified.

Resource

Full coin assessment responses use this schema:

{
  "assessment": {
    "items": [
      {
        "grade": {
          "confidence": 0.81,
          "details": "Cleaned",
          "grade": "MS-63",
          "grade_range": [
            "MS-61",
            "MS-65"
          ]
        },
        "identity": {
          "confidence": 0.96,
          "country": "United States",
          "denomination": "$1",
          "material_composition": [
            {
              "material": "SILVER",
              "unit": "grams",
              "weight": 24.057
            },
            {
              "material": "COPPER",
              "unit": "grams",
              "weight": 2.673
            }
          ],
          "mint": "D",
          "name": "1921-D Morgan Silver Dollar",
          "type": "Morgan Silver Dollar",
          "variant": "1921-D $1 (Regular Strike)",
          "year": "1921"
        },
        "valuation": {
          "confidence": 0.7,
          "melt_value": 22.5,
          "price": 85
        }
      }
    ],
    "presentation": "individual"
  },
  "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": "coin-123",
  "issues": [],
  "status": "completed"
}