Barcodes

Look up variants by barcode for scanners and POS. Supports partial match fallback.

Barcode lookup

GET /variants/barcode/:barcode returns the variant that has the given barcode. Use it when a scanner or POS sends a barcode and you need the variant id, SKU, and product info.

curl -X GET "https://your-org.inventra.io/api/v1/variants/barcode/5901234123457" \
  -H "Authorization: Bearer inv_live_xxx"

Scanner use cases

In a warehouse or store, scan a barcode to:

Reserve or fulfill an order line by SKU
Adjust inventory at a location
Look up product details for a customer

The response includes the variant and product so you can display name, SKU, and current stock.

Partial match

If no variant has an exact barcode match, the API may support a partial-match fallback (e.g. prefix match). When in doubt, use the products and variants list endpoints with a barcode filter.