Assess Coins
Assess one or more coins from submitted images. Individually presented coins and coin rolls are supported. For rolls, the assessment includes only coins that can be individually identified from the submitted images. Coin pile images are ignored when other submitted images show assessable coins; requests consisting primarily of pile images are rejected. Any identity, grade, or valuation returned applies only to the identified coins, not to a roll's unverified contents. Ancient coins, date runs, and coin sets are not currently supported.
Assess one or more coins from submitted images. Individually presented coins and coin rolls are supported. For rolls, the assessment includes only coins that can be individually identified from the submitted images. Coin pile images are ignored when other submitted images show assessable coins; requests consisting primarily of pile images are rejected. Any identity, grade, or valuation returned applies only to the identified coins, not to a roll's unverified contents. Ancient coins, date runs, and coin sets are not currently supported.
Header Parameters
Request Body
application/json
Request body for POST /coins/assessments.
images*array<object>Between 1 and 20 images. Each image can be a URL image, a base64 image, or the server-issued image_ref returned by POST /images.
Show child attributes3 shapes
Each item can be one of these shapes.
Image provided as base64 data.
images[].filename*stringFilename for the uploaded image data.
images[].data*stringBase64-encoded image bytes.
Image provided by URL.
images[].url*stringReachable image URL.
images[].filename?string | nullOptional filename to use when downloading this image.
Pre-uploaded assessment image referenced by its server-issued handle.
images[].image_ref*stringServer-issued reference returned by POST /images.
external_id?stringinclude?array<enum>Result sections to request. When omitted, the assessment uses the operations enabled for your organization. When at least one requested section is enabled, any others are omitted and reported in the response issues.
"identity" | "grade" | "valuation"Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/coins/assessments" \ -H "Content-Type: application/json" \ -d '{ "images": [ { "filename": "string", "data": "string" } ] }'{ "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", "type": "Morgan Silver Dollar", "variant": "1921-D $1 (Regular Strike)", "year": "1921", "mint": "D", "country": "United States", "denomination": "$1", "material_composition": [ { "material": "SILVER", "weight": 24.057, "unit": "grams" }, { "material": "COPPER", "weight": 2.673, "unit": "grams" } ], "confidence": 0.96 }, "grade": { "grade": "MS-63", "grade_range": [ "MS-61", "MS-65" ], "details": "Cleaned", "confidence": 0.81 }, "valuation": { "price": 85, "melt_value": 22.5, "confidence": 0.7 } } ] }, "issues": []}