Authentication

To securely access the Bühler Maintenance API, you must authenticate your requests using an Access Token. This token ensures that only authorized applications can interact with the API, protecting your data and maintaining the platform's integrity.

Obtaining an Access Token

To obtain an Access Token, contact the Bühler COPC (Customer Operation Center) — for example by email. COPC will provide you with a one-time link through which you can retrieve your Access Token.

Each Access Token is scoped to a single plant. To access data from multiple plants, request a separate token for each plant.

Upcoming change: The authentication mechanism for the Maintenance API will migrate to an OAuth 2.0 Client Credentials flow in a future release. Customers using an existing token will be notified before the switch, and this documentation will be updated accordingly.

Using the Access Token

The Access Token must be included in the Authorization header of your API requests, using the Bearer prefix.

Example of a cURL request to the Maintenance API with a Bearer Authorization header:

curl -X GET https://api.buhlergroup.com/maintenance/v1/plants/{plantId}/jobs-done -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

This results in the following HTTP 1.1 request:

GET /maintenance/v1/plants/{plantId}/jobs-done HTTP/1.1
Host: api.buhlergroup.com
Authorization: Bearer YOUR_ACCESS_TOKEN

Authorization

Each Access Token is linked to a single plant. To access data from multiple plants, request a separate token for each plant through COPC.

{"environments":[],"pdf-download":true}