REST API · v1

Automate barcode validation and generation.

Use the same validation engine as the browser tools from an ERP, PIM, warehouse workflow or custom application.

Up to 1,000 validations per request Sanitized SVG output OpenAPI 3.1 contract

Available now

The API validates EAN-13, EAN-8, UPC-A, Code 128, Code 39, ITF-14, GS1-128, Data Matrix and QR. Retail check digits can be generated automatically. Requests are limited to 1 MB and 120 calls per minute per client.

Machine-readable specificationImport the OpenAPI file into Postman, Insomnia or your SDK generator.

Open OpenAPI JSON

Validate a barcode

curl -X POST https://batch-label.com/api/v1/barcodes/validate \
  -H "Authorization: Bearer bl_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"format":"EAN13","value":"400638133393"}'

Generate raw SVG

curl -X POST https://batch-label.com/api/v1/barcodes/generate \
  -H "Authorization: Bearer bl_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: image/svg+xml" \
  -d '{"format":"QR","value":"https://example.com/product/42"}'

Authentication and access

Validation, check-digit and generation routes require a scoped API key from an active Business account. Create and revoke keys from your BatchLabel account, copy a new key when it is shown once, then send it as an Authorization: Bearer header. Keys are stored only as one-way hashes and access stops if a key is revoked or the Business plan is no longer active.

Each Business account can keep up to five active keys and includes 10,000 operations per calendar month. Requests are rate limited and successful operations are counted per key so usage can be audited without storing barcode values.