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.

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

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

User logout.

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

Unregister current user authenticated api key.

DDD upload

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.

DDD download

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

Driver data

List drivers

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

List drivers for the given company

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

Driver card

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

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

Driver violations

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

Driver violations: timestamp, description and severity.

Driver shifts

GET https://tachogram.com/api/v1/drivers/{driver_id}/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.

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.

© Tachogram, 2017