Skip to main content
GET
/
machines
List machines
curl --request GET \
  --url https://api.demo.cula.earth/tracking/v1/machines \
  --header 'Authorization: Bearer <token>' \
  --header 'Cula-Organisation-Id: <cula-organisation-id>'
{
  "data": [
    {
      "id": "mch_01kqzcjrpyf27tge6smsbnhkh5",
      "external_id": "GC-TRUCK-SCALE",
      "name": "Truck Scale",
      "site": {
        "id": "ste_01kqzcjrpyf27tge6smsbnhkh5",
        "external_id": "GC-SITE-REFINERY"
      }
    },
    {
      "id": "mch_01kqzcjrpyf27tge77evmjmnqw",
      "external_id": "GC-RAWGAS-UPGRADE",
      "name": "Rawgas Upgrade Unit 1",
      "site": {
        "id": "ste_01kqzcjrpyf27tge6smsbnhkh5",
        "external_id": "GC-SITE-REFINERY"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Exchange your client_id and client_secret for a short-lived access token, then pass it as a Bearer token in the Authorization header.

Headers

​
Cula-Organisation-Id
string
required

Organisation ID that scopes this request. The authenticated consumer must be authorized for this organisation. Omitting this header returns 400; passing an unauthorised org returns 403.

Query Parameters

​
site
string

Filter by site ID or ext-{externalId}.

Response

List of machines.

​
data
object[]
required