Get my default car
Returns the caller's default car — the car preselected on the caller's new mileage registrations.
The default car is a per-user setting (not a property of the car). It is set with IsDefault true on car create or update, or in the user's settings in the UI. If the stored car no longer exists the setting is treated as empty. With no default car the call still answers 200, with "Properties": null.
Use it to:
- Preselect the car in a mobile mileage form
Behaviour:
- Idempotent.
- Safe to retry.
- Changes are visible to the next read immediately.
Next: POST /v1/mileage-registration
See also: GET /v1/car, PUT /v1/car
Not yet documented: purpose → description; response → empty result.
curl -X GET "https://app3.timelog.com/your-account/api/v1/car/default?$expand=owner" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_TOKEN"
import requests
import json
url = "https://app3.timelog.com/your-account/api/v1/car/default?$expand=owner"
headers = {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
response = requests.get(url, headers=headers)
print(response.json())
const response = await fetch("https://app3.timelog.com/your-account/api/v1/car/default?$expand=owner", {
method: "GET",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_API_TOKEN"
}
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://app3.timelog.com/your-account/api/v1/car/default?$expand=owner", nil)
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://app3.timelog.com/your-account/api/v1/car/default?$expand=owner')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri)
request['Content-Type'] = 'application/json'
request['Authorization'] = 'Bearer YOUR_API_TOKEN'
response = http.request(request)
puts response.body
{
"Properties": {
"CarID": 358,
"Name": "jenn202306210922",
"LicensePlate": "fyh5677",
"CarType": 2,
"EmployeeUser": null,
"IsActive": true,
"ID": "c22cf8a9-352a-44da-b4d5-96e51d751065",
"EmployeeUserID": 1,
"DefaultMileageRate": null,
"IsDefault": true,
"AllowEmployeeChangeMileageRate": false
},
"Links": [
{
"Href": "https://app{server-number}.timelog.com/{account}/api/v1/car/default",
"Rel": "self"
}
]
}
{
"error": "Unauthorized",
"message": "Authentication required. Please provide a valid API token",
"code": 401
}
/v1/car/default
Target server for requests. Edit to use your own host.
OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.
Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
> Not yet documented: how to obtain a token.
> Not yet documented: token lifetime.Same expansions as the integer get (the default car is read through it).
Several values: one string, separated by ,.
Allowed values:
| Value | Name | Meaning |
|---|---|---|
| owner | owner | Fill EmployeeUser. |
| mileagerate | mileagerate | Fill DefaultMileageRate. |
Request Preview
Response
Response will appear here after sending the request
Authentication
Bearer token. OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. JWT and reference tokens are both accepted. The token must carry the required scope (default tlp).
The token's sub claim is the acting user. A token WITHOUT sub (client-credentials) acts as the system service user. If the sub user cannot log in (inactive, locked, deleted), the request is rejected with 401 — it is no longer let through without a user.
Not yet documented: how to obtain a token.
Not yet documented: token lifetime.
Query Parameters
Same expansions as the integer get (the default car is read through it).
Several values: one string, separated by ,.
Allowed values:
| Value | Name | Meaning |
|---|---|---|
owner | owner | Fill EmployeeUser. |
mileagerate | mileagerate | Fill DefaultMileageRate. |
ownermileagerateResponses
A car that mileage registrations are driven in. Two kinds exist (CarType): a COMPANY car (1) has no owner and can be picked by every employee of its legal entity; a PRIVATE car (2) belongs to exactly one employee (EmployeeUserID) and only that employee may register mileage with it. Each car belongs to one legal entity and carries a default mileage rate (the rate preselected on a mileage registration). The registration plate and the owner make a private car personal data.