Get company item price and default labor

POST/v1/catalog/items/price-labor

Request schema: CompanyItemPriceLaborBatchRequestV1
Success schema: CompanyItemPriceLaborBatchResponseV1
Documented HTTP statuses: 200, 400, 401, 403, 429, 503
Contract: company-item-content-batch-v1.openapi.json

Authorization

Current Enterprise authority is required. Manufacturer list price is not currently restricted. Labor is returned only when the represented Company holds a current license for the labor provider.

Request guidance

Send the same explicit one-through-ten selector list used by company item details. The Company's default labor provider and method come from trusted Company configuration and cannot be supplied in this request.

Request fields

Synthetic request example

{
  "items": [
    {
      "request_key": "line-1",
      "selector": {
        "item_skey": "b0f01d82-b996-11e0-b635-00137268a1bf"
      }
    }
  ]
}

Idempotency and recovery

No idempotency key is used because this POST is read-only.

Response guidance

Each available item contains item_skey and can contain Manufacturer list price, one labor_hours entry, and bounded notices. hph_item_code is included only when current Company data restrictions permit it; restricting that field does not deny the otherwise authorized response. Requested labor that is unlicensed or unavailable is omitted and acknowledged by a notice; a legitimate zero-hour value remains zero. Item-level outcomes are available, not_found_or_concealed, mapping_required, ambiguous, and temporarily_unavailable.

Synthetic success example: Manufacturer list price with default labor

{
  "contract_version": "v1",
  "results": [
    {
      "outcome": "available",
      "request_index": 0,
      "request_key": "line-1",
      "item": {
        "item_skey": "b0f01d82-b996-11e0-b635-00137268a1bf",
        "manufacturer_list_price": {
          "price_sheet_skey": "3d4c7bfc-49b0-11e9-9891-00137268a1bf",
          "price": 18.11,
          "currency": "USD",
          "unit_of_measure": "E",
          "effective_date": "2026-10-01",
          "price_sheet_number": "SYN-2026-10",
          "price_sheet_name": "Synthetic price sheet"
        },
        "labor_hours": [
          {
            "hph_labor_code": "L-SYN-001",
            "provider": "MCAA",
            "method": "COMPONENT",
            "description": "Synthetic component installation",
            "hours": 0.57,
            "unit_of_measure": "HOUR",
            "effective_date": "2026-10-01",
            "is_default": true
          }
        ],
        "notices": []
      }
    }
  ]
}

Additional response examples

Restricted HPH Item Code and unlicensed labor

{
  "contract_version": "v1",
  "results": [
    {
      "outcome": "available",
      "request_index": 0,
      "request_key": "line-1",
      "item": {
        "item_skey": "b0f01d82-b996-11e0-b635-00137268a1bf",
        "manufacturer_list_price": {
          "price_sheet_skey": "3d4c7bfc-49b0-11e9-9891-00137268a1bf",
          "price": 18.11,
          "currency": "USD",
          "unit_of_measure": "E",
          "effective_date": "2026-10-01",
          "price_sheet_number": "SYN-2026-10",
          "price_sheet_name": "Synthetic price sheet"
        },
        "notices": [
          {
            "code": "LABOR_NOT_ENTITLED",
            "title": "Labor not included",
            "description": "The requested labor provider is not available under the company's current license.",
            "target": "labor_hours",
            "provider": "MCAA",
            "method": "COMPONENT"
          }
        ]
      }
    }
  ]
}