Assess Banknotes
Identify and grade one banknote, loose or in a holder, from two photos: its front, then its back. The identity carries every field, with null for one the note has none of.
Identify and grade one banknote, loose or in a holder, from two photos: its front, then its back. The identity carries every field, with null for one the note has none of.
Request Body
application/json
Request body for POST /banknotes/assessments.
images*array<object>Exactly two images of one note: its front, then its back, both of one input type. 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 returns the sections enabled for your organization. Listing a section that is not enabled for your organization is refused with a 403.
"identity" | "grade"Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/banknotes/assessments" \ -H "Content-Type: application/json" \ -d '{ "images": [ { "filename": "string", "data": "string" }, { "filename": "string", "data": "string" } ] }'{ "assessment_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "external_id": "note-123", "status": "completed", "created_at": "2026-06-09T19:12:42.548Z", "completed_at": "2026-06-09T19:13:12.548Z", "assessment": { "items": [ { "identity": { "name": "BE2537 (1994) Thailand 100 Baht, Bank of Thailand", "type": "Thailand 100 Baht, Bank of Thailand (Pick 97)", "variant": "Wmk: King Rama IX · Security Thread Only", "year": "1994", "series": "BE2537 (1994)", "country": "Thailand", "denomination": "100 Baht", "issuer": "Bank of Thailand", "catalog_reference": "Pick 97", "variety": "Wmk: King Rama IX", "confidence": 0.81 }, "grade": { "grade": "64" } } ] }, "issues": [], "model_version": "banknotes-3f9a1c2"}