Busroot Documentation
Go to OI WebsiteRequest Access to Demo Site
  • Getting Started
    • Overview
    • Concepts and Architecture
      • Station Windows
    • Account Setup
      • Users & Authentication
    • Connecting Stations
    • Glossary
    • Releases
  • Features
    • Production Tracking
    • Asset Utilisation
    • Downtime Analysis
    • Scheduling
    • OEE Analysis
    • Energy Monitoring
    • Cycle Time Analysis
    • Lost Production Cost Analysis
    • Operator Interface
    • Shop Floor LFDs
    • Email Notifications
      • Daily Summary Email
  • Configuration
    • Plants
    • Stations
    • SKUs
    • Issue Reasons
  • Integrations
    • Real-time Station Data
    • HTTP API Reference
      • Account
      • Admin
      • Analysis Cycletime
      • ApiKey
      • Authenticate
      • Dashboard
      • Debug
      • Device
      • Energy
      • File
      • Filter
      • Health Check
      • Issue
      • Non Production Reason
      • Oee
      • OpenAPI
      • Plant
      • Production
      • Schedule
      • Shift
      • Sku
      • Sku Group
      • Station
      • Station Group
      • Station Window
      • Target
      • User
      • Models
    • PowerBI Direct Access
    • Grafana Direct Access
    • Bulk Data Export
      • CSV Download
      • S3 Sync
    • Node-RED Nodes
  • Recommended Hardware
    • Arduino Opta
      • Configuration
      • Cellular Connectivity
    • Android Tablet
    • Energy Monitors
      • 1 Phase < 100A
      • 3 Phase < 100A
      • 3 Phase < 4000A
    • Fire TV Stick
    • Diagnostic Device
  • Partner Portal
    • Overview
    • Becoming a Partner
  • Archive
    • Use Busroot
      • Live Monitoring
        • Cockpit
        • Dashboards
      • Production
        • Production Monitoring
      • OEE
        • OEE Chart
        • PT vs NPT
        • Downtime Detection
        • Utilisation Monitoring
      • Admin
        • Plants
        • Stations
        • SKU Management
        • Shift Patterns
        • Notifications
      • Production Schedules
        • Schedule CSV Upload
      • Operator Tablet
        • Interruption Tool
      • Manage Your Stations
      • Alerts and Emails
    • Workflows
      • Basic Utilisation Monitoring
      • Performance Monitoring
      • Production Progress Forecasting
      • Manual Production Progress Tracking
      • Understanding Downtime Trends
      • Understanding Production Trends
      • Daily Email Summaries
      • Adhoc Production Tracking
      • Short Interval Control
      • Wasted Energy
      • Understanding Energy Consumption Trends
      • Raw Data Access
      • Understanding OEE Trends
    • FAQs
    • CUSTOMER GUIDE TO BUSROOT
      • Requirements before and during Installation
        • Pre-Installation requirements
          • Completing the Work order form
        • What hardware will you need and do we provide it?
        • Connectivity requirements to use Busroot
        • Installation
        • Self-Installation and configuration guide
      • A user guide to getting started with your account
        • Setting up your Plant
        • Login to your account
        • Station Setup
        • SKU Setup
        • Shift Patterns
        • Notifications
      • Glossary of Busroot Menu Features and how to use them
        • Menu - Overview
        • Menu - Live Monitoring
          • Production Progress
          • Cockpit
        • Menu - Production
        • Menu - Scheduling
          • Production Schedules
          • Schedule CSV Upload
        • Menu - OEE Analysis
          • PT vs NPT
          • OEE Chart
          • Utilisation Monitoring
          • Downtime Detection
        • Menu - Energy
    • Onboarding
      • Welcome
      • Getting Started
      • Implementation
      • After the installation
      • For your IT Team
Powered by GitBook

© 2025 Output Industries Ltd

On this page
  1. Integrations
  2. HTTP API Reference

Issue

PreviousHealth CheckNextNon Production Reason
get
Authorizations
Query parameters
plantcodestring · min: 1Required
rangecodestringRequired
stationcodesany ofOptional
stringOptional
or
string[]Optional
Responses
200
200 OK
text/csv
Responsestring
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue/csv HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
text
get
Authorizations
Query parameters
stationcodesany ofRequired
stringOptional
or
string[]Optional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue/ongoing HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "isSuccess": true,
  "results": [
    {
      "id": 1,
      "type": "stop",
      "stationCode": "text",
      "startAt": "text",
      "endAt": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "startNotifiedAt": "text",
      "endNotifiedAt": "text",
      "accountId": "text",
      "excludedAt": "text",
      "events": [
        {
          "id": 1,
          "downtimeId": 1,
          "type": "acknowledge",
          "userId": 1,
          "estimateEndAt": "text",
          "notifiedAt": "text",
          "causeCode": "text",
          "accountId": "text",
          "createdAt": "text",
          "updatedAt": "text",
          "operatorInitials": "text",
          "userEmail": "text"
        }
      ],
      "isAcknowledged": true,
      "isEstimated": true,
      "isEscalated": true,
      "hasCause": true,
      "causeCode": "text",
      "estimateEndAt": "text",
      "ragStatus": "red",
      "statusText": "text",
      "stationName": "text",
      "causeBreadcrumb": [
        {
          "code": "text",
          "description": "text",
          "parentCauseCode": "text"
        }
      ],
      "startAtTimestamp": 1,
      "endAtTimestamp": 1,
      "duration": 1,
      "durationFormatted": "text",
      "skuCode": "text",
      "skuName": "text"
    }
  ]
}
get
Authorizations
Query parameters
stationcodesany ofRequired
stringOptional
or
string[]Optional
rangecodestringRequired
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue/unreported-downtime/count HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "isSuccess": true,
  "results": [
    {
      "stationCode": "text",
      "count": 1
    }
  ]
}
get
Authorizations
Query parameters
codesstringOptional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue/cause HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "isSuccess": true,
  "results": [
    {
      "code": "text",
      "description": "text",
      "parentCauseCode": "text"
    }
  ]
}
get
Authorizations
Responses
200
200 OK
text/csv
Responsestring
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue/cause/csv HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
text
delete
Authorizations
Path parameters
codestring · min: 1Required
Responses
204
204 No Content
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
delete
DELETE /api/issue/cause/{code} HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*

No content

get
Authorizations
Query parameters
plantcodestring · min: 1Required
rangecodestringRequired
aggregatewindowstringOptional
stationcodesany ofOptional
stringOptional
or
string[]Optional
skucodesany ofOptional
stringOptional
or
string[]Optional
includefuturestring · min: 1Optional
inshiftaveragesbooleanOptional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/downtime HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "isSuccess": true,
  "results": [
    {
      "stationCode": "text",
      "stationName": "text",
      "stationGroupCode": "text",
      "stationGroupName": "text",
      "reliabilityData": {
        "runningsCount": 1,
        "stopsCount": 1,
        "totalRunningTime": 1,
        "totalStoppedTime": 1
      },
      "cycleTimeAnalysis": {
        "avg": 1,
        "min": 1,
        "max": 1,
        "quantity": 1,
        "default": 1,
        "stations": [
          {
            "stationCode": "text",
            "stationName": "text",
            "avg": 1,
            "min": 1,
            "max": 1,
            "quantity": 1
          }
        ]
      },
      "oee": {
        "scheduleDuration": 1,
        "scheduleLossDuration": 1,
        "schedulePerc": 1,
        "productionScheduleDuration": 1,
        "productionScheduleLossDuration": 1,
        "productionSchedulePerc": 1,
        "availabilityDuration": 1,
        "availabilityLossDuration": 1,
        "availabilityPerc": 1,
        "performanceTargetCount": 1,
        "performanceTargetLossCount": 1,
        "performanceTargetPerc": 1,
        "goodQualityCount": 1,
        "goodQualityLossCount": 1,
        "goodQualityPerc": 1,
        "scheduledNonProduction": [
          {
            "code": "text",
            "description": "text",
            "duration": 1,
            "cost": 1,
            "percent": 1
          }
        ],
        "stops": [
          {
            "code": "text",
            "description": "text",
            "duration": 1,
            "cost": 1,
            "percent": 1
          }
        ],
        "oee": 1
      },
      "downtimes": [
        {
          "type": "stop",
          "stationCode": "text",
          "reasonCode": "text",
          "startTimestamp": 1,
          "endTimestamp": 1,
          "range": {
            "from": 1,
            "to": 1,
            "duration": 1,
            "fromIso": "text",
            "toIso": "text",
            "durationFormatted": "text"
          }
        }
      ]
    }
  ],
  "range": {
    "from": 1,
    "to": 1,
    "duration": 1,
    "fromIso": "text",
    "toIso": "text",
    "durationFormatted": "text"
  }
}
  • GET/issue
  • POST/issue
  • GET/issue/csv
  • GET/issue/ongoing
  • GET/issue/unreported-downtime/count
  • GET/issue/cause
  • POST/issue/cause
  • GET/issue/cause/csv
  • DELETE/issue/cause/{code}
  • POST/issue/{id}/event
  • GET/downtime
get
Authorizations
Query parameters
stationcodesany ofOptional
stringOptional
or
string[]Optional
rangecodestringOptional
plantcodestring · min: 1Optional
idintegerOptional
limitinteger · max: 1000Optional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
get
GET /api/issue HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Accept: */*
{
  "isSuccess": true,
  "results": [
    {
      "id": 1,
      "type": "stop",
      "stationCode": "text",
      "startAt": "text",
      "endAt": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "startNotifiedAt": "text",
      "endNotifiedAt": "text",
      "accountId": "text",
      "excludedAt": "text",
      "events": [
        {
          "id": 1,
          "downtimeId": 1,
          "type": "acknowledge",
          "userId": 1,
          "estimateEndAt": "text",
          "notifiedAt": "text",
          "causeCode": "text",
          "accountId": "text",
          "createdAt": "text",
          "updatedAt": "text",
          "operatorInitials": "text",
          "userEmail": "text"
        }
      ],
      "isAcknowledged": true,
      "isEstimated": true,
      "isEscalated": true,
      "hasCause": true,
      "causeCode": "text",
      "estimateEndAt": "text",
      "ragStatus": "red",
      "statusText": "text",
      "stationName": "text",
      "causeBreadcrumb": [
        {
          "code": "text",
          "description": "text",
          "parentCauseCode": "text"
        }
      ],
      "startAtTimestamp": 1,
      "endAtTimestamp": 1,
      "duration": 1,
      "durationFormatted": "text",
      "skuCode": "text",
      "skuName": "text"
    }
  ]
}
post
Authorizations
Body
typestring · enumRequiredPossible values:
stationCodestring · min: 1 · max: 32RequiredPattern: ^([a-zA-Z0-9-_]+)$
startAtstring · date-timeRequired
endAtstring · date-timeOptional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
post
POST /api/issue HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "type": "stop",
  "stationCode": "text",
  "startAt": "2025-05-29T13:40:45.831Z",
  "endAt": "2025-05-29T13:40:45.831Z"
}
{
  "isSuccess": true,
  "results": [
    {
      "id": 1,
      "type": "stop",
      "stationCode": "text",
      "startAt": "text",
      "endAt": "text",
      "createdAt": "text",
      "updatedAt": "text",
      "startNotifiedAt": "text",
      "endNotifiedAt": "text",
      "accountId": "text",
      "excludedAt": "text"
    }
  ]
}
post
Authorizations
Body
codestring · min: 1Required
descriptionstring · min: 1Required
parentCauseCodestring | nullableOptional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
post
POST /api/issue/cause HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 61

{
  "code": "text",
  "description": "text",
  "parentCauseCode": "text"
}
{
  "isSuccess": true,
  "result": {
    "code": "text",
    "description": "text",
    "accountId": "text",
    "parentCauseCode": "text",
    "createdAt": "text",
    "updatedAt": "text"
  }
}
post
Authorizations
Path parameters
idintegerRequired
Body
typestring · enumRequiredPossible values:
estimatedTimenumberOptional
causeCodestring · min: 1Optional
operatorstringOptional
Responses
200
200 OK
application/json
400
Bad Request - The server could not process the request due to invalid input, missing required parameters, or malformed syntax.
application/json
401
Unauthorized - Authentication is missing or invalid. Ensure you provide a valid token or credentials to access this resource.
application/json
403
Forbidden - You are authenticated but do not have permission to perform this action. Contact the administrator if you believe this is an error.
application/json
409
Conflict - The request could not be completed due to a conflict with the current state of the resource, such as a duplicate record or a versioning issue.
application/json
500
Internal Server Error - An unexpected error occurred on the server. Please try again later or contact support if the issue persists.
application/json
post
POST /api/issue/{id}/event HTTP/1.1
Host: qa.eu-west-2-2.busroot.opind.co
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 77

{
  "type": "acknowledge",
  "estimatedTime": 1,
  "causeCode": "text",
  "operator": "text"
}
{
  "isSuccess": true
}