List Machine Downtime Reasons

Beta

GET/v1/operations/machine-downtime-reasons

This endpoint is idempotent. Learn more

Returns the downtime reasons available when logging a stoppage.

The list is the same for every account and is ordered for display.

Permissions requiredValues:machine_downtime:read

The role behind your API key or agent must grant every one of these permissions.

objectstringenumValues:list

Resource type identifier.

page_infoobject

Pagination metadata.

next_page_urlstringnullable

Relative URL that fetches the next page of results.

null when the last page has been reached.

previous_page_urlstringnullable

Relative URL that fetches the previous page of results.

null while on the first page.

has_next_pageboolean

Whether more results exist after this page.

has_prev_pageboolean

Whether results exist before this page.

dataarray of machine_downtime_reason

Resources in this page.

idstring

Downtime reason ID.

objectstringenumValues:machine_downtime_reason

Resource type identifier.

codestringenumValues:breakdownchangeovermaterial_shortage

Stable code used when logging downtime.

namestring

Display name of the reason.

oee_bucketstringenumValues:availabilityperformancequality

Which OEE term this reason charges.

planning_statusstringenumValues:plannedunplanned

Whether the stoppage was scheduled in advance, such as preventive maintenance.

sort_orderinteger

Display order, ascending.

created_atstring (date-time)

Creation timestamp.

updated_atstring (date-time)

Last updated timestamp.

Responses

200

Successful response for List Machine Downtime Reasons

List Machine Downtime Reasons

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listMachineDowntimeReason = await client.operations.retrieveMachineDowntimeReasons();

console.log(listMachineDowntimeReason.data);

import Augno from '@augno/sdk';

const client = new Augno({
  bearerToken: 'YOUR_API_KEY', // Your API key goes here
});

const listMachineDowntimeReason = await client.operations.retrieveMachineDowntimeReasons();

console.log(listMachineDowntimeReason.data);

200 example

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/operations/machine-downtime-reasons?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoibWNkdHRwXzAxc2VlZGJyZWFrZG93biIsImQiOiJmIn0.e33QyAaqCKoy2bfpfgAhlJ7jgCuoCZwJMZZORcbYN3s",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "mcdttp_01seedbreakdown",
      "object": "machine_downtime_reason",
      "code": "breakdown",
      "name": "Breakdown",
      "oee_bucket": "availability",
      "planning_status": "unplanned",
      "sort_order": 10,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

{
  "object": "list",
  "page_info": {
    "next_page_url": "/v1/operations/machine-downtime-reasons?cursor=eyJjIjoiMjAyNi0wNS0xMFQwMDowMDowMFoiLCJzIjoibWNkdHRwXzAxc2VlZGJyZWFrZG93biIsImQiOiJmIn0.e33QyAaqCKoy2bfpfgAhlJ7jgCuoCZwJMZZORcbYN3s",
    "previous_page_url": null,
    "has_next_page": true,
    "has_prev_page": false
  },
  "data": [
    {
      "id": "mcdttp_01seedbreakdown",
      "object": "machine_downtime_reason",
      "code": "breakdown",
      "name": "Breakdown",
      "oee_bucket": "availability",
      "planning_status": "unplanned",
      "sort_order": 10,
      "created_at": "2026-05-10T00:00:00Z",
      "updated_at": "2026-05-10T00:23:00Z"
    }
  ]
}

List Machine Downtime Reasons

Authorization

Returns

Responses