Get Staff Margins for Special Order List Parts (View as buyer only)

GET 
/api/portal/staff/margins/special-order-items

Staff-only: margin $ and % on Special order list parts at their dealer price (dealer) and pre-order price (preorder), against both cost bases. replacement = the supplier price of the product an earlier order created from the part, else the list's STAFF-ONLY cost (synced from the sheet's cost tab, never part of any buyer response), moved by the tenant's replacement cost adjustment; average = that product's FIFO average cost, else null (never stocked). A basis with no cost is null (never 0). Same access rule as the products endpoint: only a "View as buyer" session whose staff user may manage the portal and see costs; every other caller (a buyer above all) gets 403 and no data. Responses are Cache-Control: no-store, private.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Request

Responses

200

OK

Response Headers

Content-Type
Cache-Control

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden

Response Headers

Content-Type

429

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.