Lookup variant by barcode or SKU

GET /api/v1/inventory/products/lookup

Resolve a single variant by a scannable identifier. Tries barcode first, then falls back to SKU. Used by receiving, cycle counting, and point-of-sale flows.

Operation ID: lookup_variant_api_v1_inventory_products_lookup_get · View as markdown · OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

barcode string

Scannable barcode (UPC/EAN/QR).

sku string

Stock Keeping Unit fallback.

Responses

200 Successful Response

Schema: VariantResponse

id string required

Variant UUID.

product_id string required

Parent product UUID.

business_id string required

Business UUID.

created_at string · date-time required

Creation timestamp.

updated_at string · date-time required

Last update timestamp.

name string required

Variant name.

sku string

Stock Keeping Unit.

manufacturer_sku string

Manufacturer's SKU.

barcode string

Scannable barcode (UPC/EAN/QR). Distinct from SKU.

archived boolean

Whether variant is archived.

price number

Unit price in dollars (legacy field, prefer unit_price).

cost number

Unit cost in dollars (legacy field, prefer unit_cost).

inventory_quantity integer

Current inventory quantity (legacy, prefer inventory.on_hand).

shopify_variant_id string

Shopify variant ID if synced from Shopify.

stripe_price_id string

Stripe price ID if synced to Stripe.

stripe_product_id string

Stripe product ID if synced to Stripe.

unit_price integer

Sale price in cents.

unit_cost integer

Cost price in cents.

unit_cost_precise number

Precise unit cost in dollars with sub-cent precision.

uom string

Unit of measure: EA, LB, G, KG, OZ, etc.

default_vendor_id string

Preferred vendor UUID.

inventory InventorySummary

Detailed inventory breakdown.

product_name string

Parent product name (resolved).

margin_cents integer required

Profit margin in cents (unit_price - unit_cost).

margin_percentage number required

Profit margin as percentage of sale price.

400 Bad Request - Invalid input

404 Not Found - Resource does not exist

422 Validation Error - Invalid data format