← API reference
CANONICAL TYPE REFERENCE

JobState

A print production order for one or more components. Jobs move through a defined lifecycle (draft → confirmed → in progress → complete), carry quantity and due date, and group the components, operations, and milestones needed to produce and deliver the finished product.

Unique identifier

nameString!

Job name

Ordered quantity

Due date (ISO8601)

Job status

jobNumberString

Internal job number

External system ID

Job description

Maximum deliverable quantity

tags[String!]

Job tags

Billing customer ID

Delivery customer ID

Linked estimate ID

Product template ID used to instantiate this job

Product template version used to instantiate this job

Job group this job belongs to

Scheduling priority (higher = more urgent, default 0)

Scheduled start time (ISO8601)

Scheduled end time (ISO8601)

Actual start time (ISO8601)

Actual end time (ISO8601)

Creation timestamp (ISO8601)

Last update timestamp (ISO8601)

Components of this job. Requires component:list permission.

Operations of this job. Requires operation:list permission.

All milestones of this job, including ones scoped to specific components. Requires milestone:list permission.

Billing customer. Requires customer:read permission.

Delivery customer. Requires customer:read permission.

Linked estimate. Requires estimate:read permission.

Binding/finishing type

Commercial product type

View exact SDL
"""
A print production order for one or more components. Jobs move through a defined lifecycle (draft → confirmed → in progress → complete), carry quantity and due date, and group the components, operations, and milestones needed to produce and deliver the finished product.
"""
type JobState {
  """Unique identifier"""
  id: JobID!
  """Job name"""
  name: String!
  """Ordered quantity"""
  quantity: Int!
  """Due date (ISO8601)"""
  dueAt: ISO8601
  """Job status"""
  status: JobStatus!
  """Internal job number"""
  jobNumber: String
  """External system ID"""
  externalId: String
  """Job description"""
  description: String
  """Maximum deliverable quantity"""
  maxDeliverableQuantity: Int
  """Job tags"""
  tags: [String!]
  """Billing customer ID"""
  billingCustomerId: CustomerID
  """Delivery customer ID"""
  deliveryCustomerId: CustomerID
  """Linked estimate ID"""
  estimateId: EstimateID
  """Product template ID used to instantiate this job"""
  sourceTemplateId: String
  """Product template version used to instantiate this job"""
  sourceTemplateVersion: Int
  """Job group this job belongs to"""
  jobGroupId: JobGroupID
  """Scheduling priority (higher = more urgent, default 0)"""
  priority: Int!
  """Scheduled start time (ISO8601)"""
  scheduledStartAt: ISO8601
  """Scheduled end time (ISO8601)"""
  scheduledEndAt: ISO8601
  """Actual start time (ISO8601)"""
  actualStartAt: ISO8601
  """Actual end time (ISO8601)"""
  actualEndAt: ISO8601
  """Creation timestamp (ISO8601)"""
  createdAt: ISO8601!
  """Last update timestamp (ISO8601)"""
  updatedAt: ISO8601!
  """Components of this job. Requires component:list permission."""
  components: [ComponentState!]!
  """Operations of this job. Requires operation:list permission."""
  operations: [OperationState!]!
  """
  All milestones of this job, including ones scoped to specific components. Requires milestone:list permission.
  """
  milestones: [MilestoneState!]!
  """Billing customer. Requires customer:read permission."""
  billingCustomer: CustomerState
  """Delivery customer. Requires customer:read permission."""
  deliveryCustomer: CustomerState
  """Linked estimate. Requires estimate:read permission."""
  estimate: EstimateState
  """Binding/finishing type"""
  productionKind: ProductionKind
  """Commercial product type"""
  commercialKind: CommercialKind
}

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