APIs › Image, SVG, QR & Barcode › Barcode Decoder

Barcode Decoder

Decodes one-dimensional barcodes from an image, returning symbology, payload and position.

POST /v1/barcode/decode $0.005 per call

Specification

Endpoint

POST /v1/barcode/decode

Price

$0.005 per call · tier basic_data

Payment

x402 on X Layer (chain 196) · settled in USDG or USDT0 · schemes exact, aggr_deferred

Data source

Local sandboxed processing of the uploaded image

Timeout

60 seconds

Max request

20 MB

Version

1.0.0

Calling it

The first call returns a 402 with the payment challenge. Retry with a signed authorisation in the X-PAYMENT header — see the payment guide for the exact shape.

curl -i -X POST "https://api.dana-edu.pp.ua/v1/barcode/decode" \
  -H "content-type: application/json" \
  -d '{ ... }'

Response

Real output, captured by running this endpoint at build time — not written by hand. Volatile fields such as timestamps are elided. Captured 2026-07-30.

{
  "symbols_found": 1,
  "symbols": [
    {
      "data": "5901234123457",
      "symbology": "EAN13",
      "quality": 355,
      "bounding_box": {
        "left": 76,
        "top": 11,
        "width": 371,
        "height": 177
      }
    }
  ],
  "dimensions": {
    "width": 523,
    "height": 280
  },
  "note": "QR codes are returned by /v1/qr/decode, not by this endpoint."
}

Every response is wrapped in the same envelope: data plus warnings, sources, confidence, informational_only and a measured processing_ms. See the envelope reference.

Related endpoints