Barcode Reader API

Read every 1D / 2D barcode in a PNG or JPEG: EAN-13 / 8, UPC, Code 128 / 39 / 93, ITF, QR, DataMatrix, PDF417, Aztec, with position and GS1 country.

Parameters

Example

curl -X POST "https://apibox.io.vn/v1/barcode-read" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "0=@./my-file"

const form = new FormData();
form.append('0', fileInput.files[0]);

const res = await fetch('https://apibox.io.vn/v1/barcode-read', {
  method: 'POST',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
  body: form,
});
console.log(await res.json());

import requests

res = requests.post(
    "https://apibox.io.vn/v1/barcode-read",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    files={"0": open("my-file", "rb")},
    timeout=30,
)
print(res.json())

<?php
$ch = curl_init('https://apibox.io.vn/v1/barcode-read');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => ['0' => new CURLFile('my-file')],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

Response

{
  "found": true,
  "count": 1,
  "barcodes": [
    {
      "format": "EAN13",
      "symbology": "EANUPC",
      "text": "8934588012228",
      "content_type": "Text",
      "position": {
        "top_left": {
          "x": 33,
          "y": 0
        },
        "top_right": {
          "x": 317,
          "y": 0
        },
        "bottom_right": {
          "x": 317,
          "y": 149
        },
        "bottom_left": {
          "x": 33,
          "y": 149
        }
      },
      "orientation": 0,
      "is_mirrored": false,
      "is_inverted": false,
      "gtin": {
        "gtin14": "08934588012228",
        "gs1_prefix": {
          "prefix": "893",
          "name": "GS1 Vietnam",
          "country_code": "VN"
        }
      }
    }
  ],
  "image": {
    "format": "png",
    "width": 339,
    "height": 165
  },
  "decoder": "zxing-cpp (zxing-wasm)"
}

Use cases

• Read product barcodes from photos in inventory or price-check apps
• Match shipping labels (Code 128) from parcel photos
• Read DataMatrix codes on medicine boxes
• Scan PDF417 / QR on tickets and documents uploaded by users

FAQ

Related APIs