SettingsGet my default car

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"
{
  "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"
    }
  ]
}
GET
/v1/car/default
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

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.

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
$expandstring

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. |

Options: owner, mileagerate
Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

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

$expandstring

Same expansions as the integer get (the default car is read through it).

Several values: one string, separated by ,.

Allowed values:

ValueNameMeaning
ownerownerFill EmployeeUser.
mileageratemileagerateFill DefaultMileageRate.
Allowed values:ownermileagerate

Responses

Propertiesobject

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.

Linksarray
Actionsobject[]