List Machine Status

Beta
GET/v1/operations/machine-status

This endpoint is idempotent. Learn more

Returns what every machine is running right now, how much is left on it, and what is queued behind that.

The whole floor comes back in one response rather than a page at a time, so a wall display can render it in a single call.

Assembled from the published schedule, the batches the floor has scanned against each campaign, and any open downtime. A campaign is current once its week is released and while it still has batches to scan; when the last one is scanned it hands over to the next, so this advances on its own as a shift progresses.

A machine with an open stoppage reads down even when it has a released campaign, because a broken machine is not producing whatever the plan says. A machine with nothing released reads idle, which is a state worth seeing rather than an absence from the list.

Reads the published version rather than the newest draft: the floor works to what was committed, and a draft regenerating underneath a wall display would make machines appear to change job on their own. With nothing published every machine reads idle rather than the request failing.

Permissions requiredValues:machines:read
The role behind your API key or agent must grant every one of these permissions.
department_ids[]optional array

Only include machines in these departments.

as_ofoptional string (date-time)

The moment to read the floor at.

Chooses the week the campaigns are read for, and the published schedule whose horizon covers that moment; open downtime and scan progress are always read as they stand now. Omit it to read the floor as it is at this instant.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of machine_status

Resources in this page.

objectstringenumValues:machine_status

Resource type identifier.

machineentitynullable

The machine.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

departmententitynullable

The department the machine belongs to.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

statusstringenumValues:runningidledown

What the machine is doing.

  • running: a released campaign with work still to scan.
  • idle: nothing released to it.
  • down: an open downtime event, which outranks running.
downtimeobjectnullable

The open stoppage, when the machine is down.

evententitynullable

The downtime event.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

reasonmachine_downtime_reasonnullable

Why the machine stopped.

objectstringenumValues:machine_downtime_reason

Resource type identifier.

codestringenumValues:breakdownchangeovermaterial_shortage

Stable code identifying the reason.

namestringnullable

Display name of the reason.

oee_bucketstringnullableenumValues:availabilityperformancequality

Which OEE term this reason charges.

started_atstring (date-time)

When the machine went down.

notestringnullable

Free-text note left by whoever logged it.

currentobjectnullable

The campaign the machine is working on now.

The earliest released campaign that still has batches left to scan. Once its last batch is scanned it stops being current and the queue moves on, which is what makes a floor display advance by itself.

schedule_lineentitynullable

The schedule line this campaign came from.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

itementitynullable

The item being made.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

skustring

SKU of the item.

week_starts_atstring (date-time)

First day of the week the campaign belongs to.

week_indexinteger

Zero-based week offset from the start of the horizon.

planned_quantitynumber

Quantity the plan asked for.

scanned_quantitynumber

Quantity the floor has scanned so far.

remaining_quantitynumber

Quantity still to make.

Never negative: an over-run shows up in scanned_quantity rather than as negative remaining work.

unitstringnullable

Unit the quantities are counted in.

released_batch_countinteger

Batches issued to the floor for this campaign.

scanned_batch_countinteger

Batches of this campaign the floor has scanned.

planned_run_hoursnumber

Machine hours the plan allocates to the campaign.

statusstringenumValues:plannedreleasedin_progress

Where the campaign is in its lifecycle.

  • planned: scheduled, but not yet released to the floor.
  • released: issued to the floor as a production run, so batches can be scanned against it.
  • in_progress: being run.
  • complete: finished.
  • cancelled: will not be run.
production_runentitynullable

The run carrying this campaign's work, once its week has been released.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

nextobjectnullable

What the machine takes on next, so an operator can set up for it.

When the machine has no current campaign it is between jobs, and this is the earliest campaign still ahead of it.

schedule_lineentitynullable

The schedule line this campaign came from.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

itementitynullable

The item being made.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

skustring

SKU of the item.

week_starts_atstring (date-time)

First day of the week the campaign belongs to.

week_indexinteger

Zero-based week offset from the start of the horizon.

planned_quantitynumber

Quantity the plan asked for.

scanned_quantitynumber

Quantity the floor has scanned so far.

remaining_quantitynumber

Quantity still to make.

Never negative: an over-run shows up in scanned_quantity rather than as negative remaining work.

unitstringnullable

Unit the quantities are counted in.

released_batch_countinteger

Batches issued to the floor for this campaign.

scanned_batch_countinteger

Batches of this campaign the floor has scanned.

planned_run_hoursnumber

Machine hours the plan allocates to the campaign.

statusstringenumValues:plannedreleasedin_progress

Where the campaign is in its lifecycle.

  • planned: scheduled, but not yet released to the floor.
  • released: issued to the floor as a production run, so batches can be scanned against it.
  • in_progress: being run.
  • complete: finished.
  • cancelled: will not be run.
production_runentitynullable

The run carrying this campaign's work, once its week has been released.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

week_planned_quantitynumber

Quantity planned on this machine for the current week.

Summed across every campaign scheduled on the machine that week, not just the current one.

week_scanned_quantitynumber

Quantity scanned on this machine so far in the current week.

week_planned_run_hoursnumber

Machine hours the plan allocates on this machine for the current week.

unitstringnullable

Unit the week's quantities are counted in.

Responses

200

Successful response for List Machine Status