List my cars

Lists the active cars the caller may register mileage with — the caller's own private cars plus the company cars of the caller's legal entity.

The car picker for a mileage registration. Returns, for the caller's legal entity, every ACTIVE company car and every ACTIVE private car owned by the caller, ordered by name and paged. Other employees' private cars are never listed, not even for administrators — this is "my cars", not a car register. IsDefault marks the caller's own default car.

Use it to:

Populate the car choice before POST /v1/mileage-registration (send the chosen CarID)

Not for:

Listing all cars of the account or of another employee (no such operation in REST v1)

Behaviour:

Idempotent.
Safe to retry.
Changes are visible to the next read immediately.

Next: POST /v1/mileage-registration, GET /v1/car/{id}

See also: GET /v1/car/default

Not yet documented: request → query params → $expand.

curl -X GET "https://app3.timelog.com/your-account/api/v1/car?$page=1&$pagesize=10&$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?$page=1&$pagesize=10&$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?$page=1&$pagesize=10&$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?$page=1&$pagesize=10&$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?$page=1&$pagesize=10&$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": {
    "TotalRecord": "example_string",
    "TotalPage": "example_string",
    "PageNumber": "example_string"
  },
  "Entities": [
    {
      "Properties": {
        "CarID": 123,
        "ID": "123e4567-e89b-12d3-a456-426614174000",
        "Name": "John Doe",
        "LicensePlate": "example_string",
        "CarType": 42,
        "EmployeeUserID": "null",
        "EmployeeUser": {
          "UserID": 123,
          "ID": "123e4567-e89b-12d3-a456-426614174000",
          "FirstName": "John Doe",
          "LastName": "John Doe",
          "Initials": "example_string",
          "IsActive": true,
          "UserType": "Employee",
          "LegalEntityID": 123,
          "Email": "user@example.com"
        },
        "IsActive": true,
        "DefaultMileageRate": {
          "ID": "123e4567-e89b-12d3-a456-426614174000",
          "MileageRateID": 123,
          "Name": "John Doe",
          "IsActive": true,
          "SalaryCodeTaxFree": "null",
          "SalaryCodeTaxable": "null",
          "AccountNumber": "null",
          "IsDefaultForPrivateCar": true,
          "HasReimbursement": true,
          "UnitType": 42,
          "ReimbursementCurrencyID": 123,
          "LegalEntityID": 123
        },
        "IsDefault": true,
        "AllowEmployeeChangeMileageRate": true
      },
      "Links": [
        {
          "Href": "example_string",
          "Rel": "example_string"
        }
      ],
      "Actions": [
        {}
      ]
    }
  ],
  "Links": [
    {
      "Href": "example_string",
      "Rel": "example_string"
    }
  ]
}

GET

/v1/car

GET

Base URLstring

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

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

$pageinteger

Page number (1-based).

query

$pagesizeinteger

Page size. No maximum enforced in the API layer.

query

$expandstring

Several values: one string, separated by ,. Allowed values: | Value | Name | Meaning | |---|---|---| | owner | owner | Fill EmployeeUser (the owner's user record, incl. e-mail) on private cars. | | mileagerate | mileagerate | Fill DefaultMileageRate (the car's default mileage rate). |

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

$pageinteger

Page number (1-based).

$pagesizeinteger

Page size. No maximum enforced in the API layer.

$expandstring

Several values: one string, separated by ,.

Allowed values:

Value	Name	Meaning
`owner`	owner	Fill EmployeeUser (the owner's user record, incl. e-mail) on private cars.
`mileagerate`	mileagerate	Fill DefaultMileageRate (the car's default mileage rate).

Allowed values:ownermileagerate

Responses

Propertiesobject

Paging values. They are returned as STRINGS, for example "TotalRecord": "12".

Entitiesarray

Omitted (not []) when the list is empty.

Linksarray

Was this page helpful?