Contracts

The endpoint retrieves contract information for equipment in the specified location. One equipment can have multiple contracts. The different contract informations are provided through the endpoints below with example use cases and example entries.

Definition
  • Contracts: Shows contract information for equipments in a location. Information: contract type(s), the contract period(s) and included operating hours.
Contracts
/locations/{location_id}/contracts/v2
Example entity
{
  "data": [
    {
      "equipment_number": "test_909630828",
      "equipment_id": "61d1d5c4410e4339556fc144c2dc1b6e79e67db6d3f4d5f27e441be71c66595e",
      "service_contract": {
        "main_contract": {
          "contract_end_date": "2050-11-15T14:48:08.556Z",
          "operation_hours_per_annum": 85635,
          "operation_hours_at_start": 836,
          "contract_type": "full_service",
          "contract_number": "3498574698512384",
          "contract_start_date": "2016-09-14T07:33:31.996Z",
          "contract_type_english": "Full service"
        },
        "additional_contracts": [
          {
            "contract_type": "machine_damage",
            "contract_type_english": "Machine damage"
          },
          {
            "contract_type": "service_flat_charge",
            "contract_type_english": "Various services"
          }
        ]
      },
      "sales_contract": {
        "contract_end_date": "2024-07-30T11:11:21.769Z",
        "contract_type": "financed",
        "contract_number": "7067701319041024",
        "contract_start_date": "2024-01-04T11:09:55.776Z",
        "rental_fleet_management_type": "subscription",
        "contract_type_english": "Financed"
      }
    },
    {
      "equipment_number": "test_1053041225",
      "equipment_id": "e6776ac5c797b2b433d91206264e20ca9d3746bcecb987267e87469f18243b44",
      "sales_contract": null,
      "service_contract": null
    }
  ]
}