Get product variant

GET /api/v1/inventory/products/variants/{id}

Retrieve a specific variant by ID.

Operation ID: get_variant_api_v1_inventory_products_variants__id__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

Path

id string · uuid required

Responses

200 Successful Response

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.

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.

404 Business or variant not found

422 Invalid variant ID