Credentials
Your Secret Key, provided by your TachoHouse account manager. Required to generate a new API Key.
Sent as the Authorization header on every request. Only valid for 7 days — refresh daily.
New key
{{SCGetNewKey.data.apiGenerateNewKey.data.new_api_key}}
expires at {{SCGetNewKey.data.apiGenerateNewKey.data.expires_at}}
Customers
By default lists all active customers.
Also shows the company's depots alongside its customers.
| Name | ID | Address | Postcode | Status | Created |
|---|---|---|---|---|---|
No customers loaded yet — click Run.
{{'GET ' + '/tachohouse/api/integration/customers' + '?incDepots=' + checkboxIncDepots.checked + '&status=' + selectCustomerStatus.value + '\nAuthorization: ' + textauth.value}}
{{SCAPIGetCustomers.data.stringify()}}
Drivers
If left blank, defaults to the parent company of the API Key.
If left blank, lists drivers from all depots.
| Name | Card serial number | Customer ID | Depot ID | Status | Created |
|---|---|---|---|---|---|
No drivers loaded yet — enter a customer GUID and click Run.
{{'GET ' + '/tachohouse/api/integration/drivers' + '?customerId=' + textCustGUID.value + '&depotId=' + textDepotID.value + '&status=' + selectDriverStatus.value + '\nAuthorization: ' + textauth.value}}
{{SCAPIGetDrivers.data.stringify()}}
Infringements
Required. Defaults to the parent company of the API Key.
If left blank, lists infringements for all drivers.
"Open" covers unacknowledged/awaiting-response/disputed/signed-off. "Closed" covers closed-off/auto-closed-off.
| Infringement ID | Date/Time | Infringement | Band | Driver | Card serial number | Status |
|---|---|---|---|---|---|---|
No infringements loaded yet — set your filters and click Run.
{{'GET ' + '/tachohouse/api/integration/infringements' + '?customerId=' + textInfCustGUID.value + '&driverCardNumber=' + textInfDriverCardID.value + '&status=' + selectOpenOnly.value + '&dateFrom=' + textDateFrom.value + '&dateTo=' + textDateTo.value + '\nAuthorization: ' + textauth.value}}
{{SCAPIInfringements.data.stringify()}}
Full Infringement Details
Required — lists the full detail of this infringement, including every activity in that shift.
Driver
Card serial number
Infringement
Band
Status
Duty start
Duty end
Created
No details loaded yet — enter an infringement ID and click Run.
Full response
Every field returned by the API for this infringement, including duty activity changes and registrations, however the endpoint returns them.
{{'POST ' + '/tachohouse/api/integration/infringements/' + textDetailsInfringementID.value + '/details' + '\nAuthorization: ' + textauth.value}}
{{SCAPIInfringementDetails.data.stringify()}}
Sign Off Infringement
Optional — where the driver can add a comment.
Signed off successfully
{{'POST ' + '/tachohouse/api/integration/infringements/' + textInfringementID.value + '/sign-off' + '\nAuthorization: ' + textauth.value + '\nContent-Type: application/json\n\n{\n ' + '"status": "' + selectInfStatus.value + '",\n "driverComment": "' + textInfComment.value + '"' + '\n}'}}
{{SCSignOffInfringement.data.stringify()}}
Add Customer
{{'POST ' + '/tachohouse/api/integration/customers/add' + '\nAuthorization: ' + textauth.value + '\nContent-Type: application/json\n\n{\n ' + '"customerName": "' + textAddCustName.value + '",\n "customerEmail": "' + textAddCustEmail.value + '"' + '\n}'}}
{{SCAddCustomer.data.stringify()}}
Driver Details
{{'GET ' + '/tachohouse/api/integration/drivers/' + textDriverDetailsGUID.value + '/details' + '\nAuthorization: ' + textauth.value}}
{{SCDriverDetails.data.stringify()}}
Driver Duties
{{'GET ' + '/tachohouse/api/integration/drivers/' + textDriverDutiesGUID.value + '/duties' + '\nAuthorization: ' + textauth.value}}
{{SCDriverDuties.data.stringify()}}
Driver Duty
{{'GET ' + '/tachohouse/api/integration/drivers/' + textDriverDutyGUID.value + '/duty' + '?activityDate=' + textDriverDutyDate.value + '\nAuthorization: ' + textauth.value}}
{{SCDriverDuty.data.stringify()}}
Driver Raw Day
{{'GET ' + '/tachohouse/api/integration/drivers/' + textDriverRawDayGUID.value + '/raw-day' + '?activityDate=' + textDriverRawDayDate.value + '\nAuthorization: ' + textauth.value}}
{{SCDriverRawDay.data.stringify()}}
Download History
Optional, must be divisible by 50.
{{'GET ' + '/tachohouse/api/integration/drivers/' + textDriverHistoryGUID.value + '/download-history' + '?offset=' + textDriverHistoryOffset.value + '\nAuthorization: ' + textauth.value}}
{{SCDriverDownloadHistory.data.stringify()}}
Vehicles
{{'GET ' + '/tachohouse/api/integration/vehicles' + '\nAuthorization: ' + textauth.value}}
{{SCVehicles.data.stringify()}}
Vehicle Details
{{'GET ' + '/tachohouse/api/integration/vehicles/' + textVehicleDetailsGUID.value + '/details' + '\nAuthorization: ' + textauth.value}}
{{SCVehicleDetails.data.stringify()}}
Vehicle Duty
{{'GET ' + '/tachohouse/api/integration/vehicles/' + textVehicleDutyGUID.value + '/duty' + '?dateFrom=' + textVehicleDutyFrom.value + '&dateTo=' + textVehicleDutyTo.value + '\nAuthorization: ' + textauth.value}}
{{SCVehicleDuty.data.stringify()}}
Vehicle Day
{{'GET ' + '/tachohouse/api/integration/vehicles/' + textVehicleDayGUID.value + '/day' + '?activityDate=' + textVehicleDayDate.value + '\nAuthorization: ' + textauth.value}}
{{SCVehicleDay.data.stringify()}}
Planning
{{'GET ' + '/tachohouse/api/integration/planning' + '\nAuthorization: ' + textauth.value}}
{{SCPlanning.data.stringify()}}
Missing KM
{{'GET ' + '/tachohouse/api/integration/missing-km' + '\nAuthorization: ' + textauth.value}}
{{SCMissingKm.data.stringify()}}
Missing KM (Full)
{{'GET ' + '/tachohouse/api/integration/missing-km/full' + '?vehicleId=' + textMissingKmVehicleID.value + '&activityDate=' + textMissingKmDate.value + '\nAuthorization: ' + textauth.value}}
{{SCMissingKmFull.data.stringify()}}
Acknowledge Missing KM
{{'POST ' + '/tachohouse/api/integration/missing-km/acknowledge' + '?vehicleId=' + textAckVehicleID.value + '&activityDate=' + textAckDate.value + '\nAuthorization: ' + textauth.value + '\nContent-Type: application/json\n\n{\n ' + '"comment": "' + textAckComment.value + '",\n "category": "' + selectAckCategory.value + '",\n "driverId": "' + textAckDriverID.value + '"' + '\n}'}}
{{SCMissingKmAck.data.stringify()}}
Raw Data Download
{{'GET ' + '/tachohouse/api/integration/raw-data/download' + '\nAuthorization: ' + textauth.value}}
{{SCRawDataDownload.data.stringify()}}