User authorization request.

GET https://tachogram.com/api/v1/user/authorize

Performs user authorization by given email && password. When success returns authorized api key.

User logout.

GET https://tachogram.com/api/v1/user/logout

Unregister current user authenticated api key.

Upload a DDD file

POST https://tachogram.com/api/v1/upload

Upload a DDD file for processing. Processed data will be available in Tachogram web interface

Get file upload status

POST https://tachogram.com/api/v1/upload/status

Get uploaded DDD file data processing status.

status *

{new, processing, finished, failed}

Uploaded file processing status.

cardNumber

string

Extracted card number. If uploaded file was a driver file.

driver

Driver

Extracted driver identification data. If uploaded file was a driver file.

id *

string

Tachogram ID of driver, used in other requests

name *

string

surname *

string

birthdate *

string

Birth date YYYY-MM-DD

last_download *

string

Date of last download, YYYY-MM-DD format

deactivated *

boolean

Flag that shows if driver is deactivated

queue *

integer

Number of files queued prior current one.

estimate *

integer

Estimated processed time from now in seconds.

error

integer

Error message if status = "error"

List DDD files for a driver

get https://tachogram.com/api/v1/files/driver/list

List all files of a driver.

Download a file

get https://tachogram.com/api/v1/files/driver/download

Download DDD file from Tachogram

Store driver user

POST https://tachogram.com/api/v1/business/driver-users

Business companies can create a user for driver providing email, password and driver card number.

success *

boolean

user

Newly created user data

name

string

email

string

company_id

integer

updated_at

string

Date updated (Y-m-d H:i:s)

created_at

string

Date created (Y-m-d H:i:s)

id

integer

email_confirmed

integer

email_confirmed_at

string

(Y-m-d H:i:s)

email_confirmation_sent_at

string

(Y-m-d H:i:s)

errors

email

email related errors

string[]

password

password related errors

string[]

card_number

card_number related errors

string[]

driver

driver related errors

string[]

Delete driver user

DELETE https://tachogram.com/api/v1/business/driver-users

Business company can delete a created driver user profile by providing card number. Driver data remains only the user is deleted.

List drivers

GET https://tachogram.com/api/v1/drivers/list

List drivers for the given company

drivers *

Driver[]

id *

string

Tachogram ID of driver, used in other requests

name *

string

surname *

string

birthdate *

string

Birth date YYYY-MM-DD

last_download *

string

Date of last download, YYYY-MM-DD format

deactivated *

boolean

Flag that shows if driver is deactivated

extraFields

DriverExtraFields

Value as well as all fields in it is optional

personal_id *

string

place_of_residence *

string

ISO 3166-1 alpha-2 country code

Driver card insertion and withdrawal events.

GET https://tachogram.com/api/v1/drivers/cardstatus

See Response tab for detailed information about the response data.

Working times

GET https://tachogram.com/api/v1/drivers/workingtimes

Returns working time data for requested dates

workingtimes *

WorkingTimes[]

date *

string

Date, e.g. 2023-03-29

manual_driving *

integer

Manual segment of Driving time (according to company settings, in seconds)

manual_driving_night *

integer

Manual segment of Driving time at night (according to company settings, in seconds)

manual_working *

integer

Manual segment of Working time (according to company settings, in seconds)

manual_working_night *

integer

Manual segment of Working time at night (according to company settings, in seconds)

driving *

integer

Driving time (according to company settings, in seconds)

driving_night *

integer

Driving time at night (according to company settings, in seconds)

working *

integer

Working time (according to company settings, in seconds)

working_night *

integer

Working time at night (according to company settings, in seconds)

country_start *

string

Country (2 character code) in which shift was started.

country_end *

string

Country (2 character code) in which shift was finished

total *

integer

Total duration of all activities (rest, drive, work, available, unknown). Can be used to check whether Tachogram has data of a full day.

Working times grouped by vehicles

GET https://tachogram.com/api/v1/drivers/workingtimes-vehicle

Returns working time data for requested dates, grouped by vehicles

workingtimes *

WorkingTimes[]

date *

string

Date, e.g. 2023-03-29

manual_driving *

integer

Manual segment of Driving time (according to company settings, in seconds)

manual_driving_night *

integer

Manual segment of Driving time at night (according to company settings, in seconds)

manual_working *

integer

Manual segment of Working time (according to company settings, in seconds)

manual_working_night *

integer

Manual segment of Working time at night (according to company settings, in seconds)

driving *

integer

Driving time (according to company settings, in seconds)

driving_night *

integer

Driving time at night (according to company settings, in seconds)

working *

integer

Working time (according to company settings, in seconds)

working_night *

integer

Working time at night (according to company settings, in seconds)

country_start *

string

Country (2 character code) in which shift was started.

country_end *

string

Country (2 character code) in which shift was finished

total *

integer

Total duration of all activities (rest, drive, work, available, unknown). Can be used to check whether Tachogram has data of a full day.

vehicle *

string

Vehicle registration number

Working times archive

POST https://tachogram.com/api/v1/drivers/workingtimes-bulk

Sends an email attachment containing working times for requested drivers

Working times archive processing status

GET https://tachogram.com/api/v1/drivers/workingtimes-bulk/status

Status of processing request

Driver card

GET https://tachogram.com/api/v1/drivers/{driver_id}/card

Driver card current information: name, surname, expiry date, card number.

All driver cards

GET https://tachogram.com/api/v1/drivers/{driver_id}/all-cards

All driver cards: card number, issue date, expiry date.

Driver violations

GET https://tachogram.com/api/v1/drivers/{driver_id}/violations

Driver violations: timestamp, description and severity.

violations *

Violation[]

timestamp *

integer

Violation timestamp UTC

severity *

{most-serious, very-serious, serious, minor}

level of violation severity

type *

string

Short description

type_code *

integer

Internal violation type

description *

string

Full description

article *

string

Article of EU regulation that refers to this specific violation

group *

string

Infringement group according to Commission Regulation (EU) 2016/403

extra *

mixed

allowed_time and total_time values as array

navigationObj *

mixed

url parameters for @next and @prev request issue

error

string

fail message

Driver overspeeding events

GET https://tachogram.com/api/v1/drivers/{driver_id}/overspeeding

Driver overspeeding events: timestamp, duration, speed and vehicle.

violations *

Event[]

start *

string

Start datetime in YYYY-MM-DD HH:II:SS format in user's timezone

end *

string

End datetime in YYYY-MM-DD HH:II:SS format in user's timezone

startTimestamp *

integer

Event start UTC timestamp

endTimestamp *

integer

Event end UTC timestamp

duration *

string

Human readable event duration (e.g. 1h 15min 26s)

durationTime *

integer

Event duration in seconds

maxSpeed *

integer

Maximum speed during the event, km/h

avgSpeed *

integer

Average speed during the event

similarEvents *

integer

Number of similar events

vehicleId *

integer

ID for the vehicle used

vehicleNumber *

string

Registration number for the vehicle used

navigationObj *

mixed

url parameters for @next and @prev request issue

error

string

fail message

Driver shifts

GET https://tachogram.com/api/v1/drivers/{driver_id_or_driver_card_number}/shifts

Driver shifts data with remaining reduced rests, extended driving times and remaining driving time according to daily driving limits and weekly/bi-weekly driving limits.

shifts *

Shifts[]

shiftStart *

integer

Unix timestamp of shift start

shiftEnd *

integer

Unix timestamp of shift end

drivingTime *

integer

Driving time during this shift in seconds

reducedRestsRemaining *

integer

Number of reduced rests remaining at the last second of current shift (values 0-3). If 0 - driver has to do a full 11 hour rest

extendedDrivingRemaining *

integer

Number of 10 hour extended driving extensions left (values 0-2). If 0 - driver has used all his driving extensions

drivingTimeRemaining *

integer

Remaining driving time in seconds. Daily driving limits, weekly and bi-weekly driving limits are taken into account

lastData *

integer

Last data imported UNIX timestamp. Last shift cannot be considered completed if it matches the last shift end in shifts array.

Driver shift countries

GET https://tachogram.com/api/v1/drivers/{driver_id_or_driver_card_number}/shift-countries

Driver shift start/end countries data.

Driver fixed weeks data

GET https://tachogram.com/api/v1/drivers/{driver_id}/weeks

Driver fixed weeks data with remaining extended driving times, remaining driving time this week, whether Tachogram has full week data.

Driver 6x24 hour working periods data

GET https://tachogram.com/api/v1/drivers/{driver_id}/workingperiods

Driver 6x24 hour working periods efficiency data. Can be used to determine whether driver could drive additional time before he took the next weekly rest of 24 or 45 hours.

Driver files list

GET https://tachogram.com/api/v1/drivers/{id}/files/list

Paginated driver files.

Driver file download

GET https://tachogram.com/api/v1/drivers/{id}/files/{hash}/download

Download driver file.

Create Driver Account

POST https://tachogram.com/api/v1/drivers/{driver_id}/create-account

Business type users may call this endpoint in order to create explicit login for company driver.

Find drivers by vehicle used

GET https://tachogram.com/api/v1/drivers/find-drivers-by-vehicle

Search drivers which have used a specific vehicle. Vehicle registration number plates are normalized and cleaned from whitespace and dashes. So make sure to search by number plates without spaces and dashes.

data *

VehicleUsed[]

driver_id *

integer

Driver ID

vehicle_id *

integer

Vechile ID

driver_cards *

DriverCard[]

card_number *

string

Driver card number

valid_from *

string

Driver card issue date, for example: 2023-03-19

valid_to *

string

Driver card expiry date, for example: 2023-03-29

card_nation *

integer

Driver card issuing country

intervals *

DateIntervals[]

utc_start *

string

Start date, for example: 2023-03-19 15:53:05

utc_end *

string

End date, for example: 2023-03-29 15:53:05

error

string

fail message

Driver activities

get https://tachogram.com/api/v1/drivers/activities

Driver activities.

driver *

Driver

id *

string

Tachogram ID of driver, used in other requests

name *

string

surname *

string

birthdate *

string

Birth date YYYY-MM-DD

last_download *

string

Date of last download, YYYY-MM-DD format

deactivated *

boolean

Flag that shows if driver is deactivated

driver_cards *

DriverCard[]

Driver cards

card_number *

string

Driver card number

valid_from *

string

Driver card issue date, for example: 2023-03-19

valid_to *

string

Driver card expiry date, for example: 2023-03-29

card_nation *

integer

Driver card issuing country

activities *

Activities[]

Activities

start *

integer

UTC timestamp of activity start

end *

integer

UTC timestamp of activity end

state *

{DRIVE, WORK, AVAILABLE, REST, UNKNOWN}

Driver activity state. One of values.

crew *

boolean

Whether the activity is a crew activity

slot *

integer

Which slot the card was inserted in (0 - driver, 1, co-driver)

manual *

integer

Whether specific activity was recorded manually

override *

Override[]

If activity overrides are enabled, shows override

state *

{DRIVE, WORK, AVAILABLE, REST, UNKNOWN}

Driver overridden activity state. One of values.

Driver country intervals

get https://tachogram.com/api/v1/drivers/{id}/driver-countries-intervals

List of driver country intervals.

Working times per country by date

GET https://tachogram.com/api/v1/drivers/working-times-per-country/by-date

Returns working time per country for requested dates

summary *

Summary[]

country *

string

ISO 3166-1 alpha-2 code

workday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

saturday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

holiday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

data *

Country[]

date *

string

Date in YYYY-MM-DD format

countries *

Country[]

country *

string

ISO 3166-1 alpha-2 code

isHoliday *

boolean

Is true if it is Sunday or holiday

data *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

Working times per country by country

GET https://tachogram.com/api/v1/drivers/working-times-per-country/by-country

Returns working time per country for requested dates

summary *

Summary[]

country *

string

ISO 3166-1 alpha-2 code

workday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

saturday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

holiday *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

data *

Country[]

country *

string

ISO 3166-1 alpha-2 code

days *

Day[]

date *

string

Date in YYYY-MM-DD format

isHoliday *

boolean

Is true if it is Sunday or holiday

data *

ActivityStates

drive *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

work *

TimeOfDay

day *

integer

Activity time in day (in seconds)

evening *

integer

Activity time in evening (in seconds)

night *

integer

Activity time in night (in seconds)

rest

integer

Rest time in seconds

available

integer

Availability time in seconds

Driver used vehicles

GET https://tachogram.com/api/v1/drivers/{driver_id_or_driver_card_number}/vehicles-used

Returns used vehicles for specific time period.

Vehicles list

GET https://tachogram.com/api/v1/vehicles/list

Returns a list of vehicles owned by company.

Working times from Vehicle DDD file data

GET https://tachogram.com/api/v1/vehicles/workingtimes

Returns working time data for requested dates for a specific vehicle and group by drivers/slots

workingtimes *

WorkingTimes[]

slot *

string

DRIVER or CODRIVER

driver *

driver_id *

integer

Driver ID

card_number *

string

Driver card number

all_cards *

DriverCard[]

card_number *

string

Driver card number

valid_from *

string

Driver card issue date, for example: 2023-03-19

valid_to *

string

Driver card expiry date, for example: 2023-03-29

card_nation *

integer

Driver card issuing country

data *

date *

string

Date Y-m-d

driving *

integer

Driving time in seconds

driving_night *

integer

Night driving time in seconds

working *

integer

Working time in seconds

working_night *

integer

Night working time in seconds

manual_working *

integer

Manual working time in seconds

manual_working_night *

integer

Manual night working time in seconds

manual_driving *

integer

Manual driving time in seconds

manual_driving_night *

integer

Manual night driving time in seconds

Get activities from vehicle

GET https://tachogram.com/api/v1/vehicles/activities

Returns activities from vehicles.

activities *

VehicleActivities[]

card_number *

string

Driver card number

activities *

Activities[]

start *

integer

UTC timestamp of activity start

end *

integer

UTC timestamp of activity end

state *

{DRIVE, WORK, AVAILABLE, REST, UNKNOWN}

Driver activity state. One of values.

crew *

boolean

Whether the activity is a crew activity

slot *

integer

Which slot the card was inserted in (0 - driver, 1, co-driver)

manual *

integer

Whether specific activity was recorded manually

override *

Override[]

If activity overrides are enabled, shows override

state *

{DRIVE, WORK, AVAILABLE, REST, UNKNOWN}

Driver overridden activity state. One of values.

Cookie settings

API documentation

Tachogram API is being constantly updated by listening to our customers and integration partners. If some of the data you are looking for is not available via API, we would like to hear from you.

User

User authorization request.

User logout.

DDD upload

Upload a DDD file

Get file upload status

DDD download

List DDD files for a driver

Download a file

Driver

Store driver user

Delete driver user

Driver data

List drivers

Driver card insertion and withdrawal events.

Working times

Working times grouped by vehicles

Working times archive

Working times archive processing status

Driver card

All driver cards

Driver violations

Driver overspeeding events

Driver shifts

Driver shift countries

Driver fixed weeks data

Driver 6x24 hour working periods data

Driver files list

Driver file download

Create Driver Account

Find drivers by vehicle used

Driver activities

Driver country intervals

Working times per country by date

Working times per country by country

Driver used vehicles

Vehicle data

Vehicles list

Working times from Vehicle DDD file data

Get activities from vehicle