Banknotes

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.

POSThttps://api.vardera.com/banknotes/assessments

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.

base64 imageobject

Image provided as base64 data.

images[].filename*string

Filename for the uploaded image data.

images[].data*string

Base64-encoded image bytes.

URL imageobject

Image provided by URL.

images[].url*string

Reachable image URL.

images[].filename?string | null

Optional filename to use when downloading this image.

Shape 3object

Pre-uploaded assessment image referenced by its server-issued handle.

images[].image_ref*string

Server-issued reference returned by POST /images.

external_id?string
include?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.

Value in"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"}