← API reference
CANONICAL TYPE REFERENCE

JobMaterialReservationState

Material demand for a job — tracks required vs reserved warehouse stock

Unique identifier

Job this reservation belongs to

The material being reserved, resolved from (stockableType, stockableId) to the concrete catalog entity by the active vertical; falls back to a StockableMarker when the vertical cannot resolve it.

Total quantity needed

Quantity already reserved from stock

Remaining quantity to reserve

Unit of measure

Preferred warehouse location for picking

notesString

Internal notes

Reservation lifecycle status

createdAtString!

Creation timestamp (ISO8601)

updatedAtString!

Last update timestamp (ISO8601)

View exact SDL
"""
Material demand for a job — tracks required vs reserved warehouse stock
"""
type JobMaterialReservationState {
  """Unique identifier"""
  id: JobMaterialReservationID!
  """Job this reservation belongs to"""
  jobId: JobID!
  """
  The material being reserved, resolved from (stockableType, stockableId) to the concrete catalog entity by the active vertical; falls back to a StockableMarker when the vertical cannot resolve it.
  """
  stockable: Stockable!
  """Total quantity needed"""
  requiredQuantity: Float!
  """Quantity already reserved from stock"""
  reservedQuantity: Float!
  """Remaining quantity to reserve"""
  availableToReserve: Float!
  """Unit of measure"""
  unit: MeasurementUnit!
  """Preferred warehouse location for picking"""
  preferredLocationId: WarehouseLocationID
  """Internal notes"""
  notes: String
  """Reservation lifecycle status"""
  status: MaterialReservationStatus!
  """Creation timestamp (ISO8601)"""
  createdAt: String!
  """Last update timestamp (ISO8601)"""
  updatedAt: String!
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.