Docs/Account

Decode a scan code

Resolve a scan code to a card number.

POSThttps://api.vaelor.chat/v1/scan/decode

Resolves a numeric scan code from a Vaelor scan card into its card number. This endpoint is public — it doesn't need an API key — and it's free.

Body#

codeintegerRequired

The scan code, from 0 to 32,767. The whole body must be 128 bytes or less.

Response#

cardNumberstring

The card number the code resolves to.

Example#

curl https://api.vaelor.chat/v1/scan/decode \
  -H "Content-Type: application/json" \
  -d '{"code": 12873}'

const { cardNumber } = await fetch('https://api.vaelor.chat/v1/scan/decode', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ code: 12873 })
}).then((response) => response.json())

card = requests.post("https://api.vaelor.chat/v1/scan/decode", json={"code": 12873}).json()

Response200

JSON

{ "cardNumber": "VLR-0417-2291" }

Errors#

Status	When
`400`	The code is missing, out of range, or the body is too large.
`503`	Decoding is temporarily unavailable.

Was this page helpful?

Questions? Contact support

Retrieve usage

Long-form drafts

Last updated October 20, 2026