Get Product Density
GET/api/manufacturing/products/:product/density
Get the product's density, where it came from, and the unit-of-measure rows that depend on it. Density drives every weight↔volume conversion on the product's units of measure: once set, the factor for each cross-type unit (e.g. gallons on a product stocked in grams) is derived from it rather than typed in. Auth: requires Bearer token. Path param: product = product id.
manufacturing:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Response fields: density_g_per_ml (the stored value, g/mL; specific gravity is numerically equal), density_lb_per_gal (the same value in lb per US gallon), specific_gravity, source (manual | supplier_spec | ai_lookup | measured), basis (free text — temperature, lot, document reference, or the AI basis line), set_at, set_by (id + name), ai_lookup_available (whether Suggest Product Density can be called on this account), derived_rows (the product's weight↔volume rows whose factor comes from this density, each with uom_id, uom_code, factor and equation), pending_cross_type_uom_codes (weight↔volume units enabled on the product that are still waiting for a density before they get a factor). All density fields are null when no density is set.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.