Creates a new car travel record.

Request Information

URI Parameters :

None.

Body Parameters :

car_travel
NameDescriptionTypeAdditional information
id

Primary Key

 globally unique identifier
user_id

Foreign key of User

 globally unique identifier

Required
car_id

Foreign key of Car

 globally unique identifier

Required
from_db_address_id

the FROM info are filled with the latest travel of this car

 globally unique identifier
from_db_table_id

Identifier of the database table that belongs to, when the departure point is linked to another record (e.g. a job).

 globally unique identifier
from_id_in_table

Primary key of the linked departure record in the table identified by .

 globally unique identifier
from_travel_type_code

Kind of departure point (e.g. home, office, previous job).

 string
from_db_address_other

Free-text departure address, used when the departure point isn't one of the standard linked records.

 string

Max length: 255
to_db_address_id

The address used on navigation

 globally unique identifier
to_db_table_id

TO=> if navigate to a JOBS, to_db_table_id and to_in_table is filled with the jobs info

 globally unique identifier
to_in_in_table

Primary key of the linked destination record in the table identified by .

 globally unique identifier
to_travel_type_code

Kind of travel. Can be

 string

Required
to_db_address_other

Free-text destination address, used when the destination isn't one of the standard linked records.

 string

Max length: 255
hour_type_id

Foreign key of the hour type

 globally unique identifier

Required
date_from

Local date+time when the travel started

 date
date_from_rounded

rounded to the nearest configured interval, used for billing/display.

 date

Required
date_to

local date+time when the travel finished

 date
date_to_rounded

rounded to the nearest configured interval, used for billing/display.

 date

Required
notes

Additional notes field

 string

Max length: 4000
km

2019-04-01: Old field not use it anymore (FSA-986) the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one

 integer
km_before

Auto filled when a new record is added

 integer
km_after

the Mileage of the car after the travel,* Be aware, value should be always bigger than the last one

 integer
km_private

A value the user indicates that contains the total number of km for Private use.

 integer
km_distance

Distance traveled, in kilometers, computed as minus .

 integer
is_time_for_money

Indicates this travel time is billable ("time for money") rather than purely informational.

 boolean
is_start_stop

Indicates this entry was recorded via a start/stop timer rather than manually keyed in.

 boolean
property_1_checked

Checked state of the hour type's configurable custom property #1 (see ) for this entry.

 boolean
property_2_checked

Checked state of the hour type's configurable custom property #2 for this entry.

 boolean
property_3_checked

Checked state of the hour type's configurable custom property #3 for this entry.

 boolean
property_4_checked

Checked state of the hour type's configurable custom property #4 for this entry.

 boolean
property_5_checked

Checked state of the hour type's configurable custom property #5 for this entry.

 boolean
start_latitude_decimal

Latitude of the user's location when the travel was started.

 decimal number
start_longitude_decimal

Longitude of the user's location when the travel was started.

 decimal number
end_latitude_decimal

Latitude of the user's location when the travel ended.

 decimal number
end_longitude_decimal

Longitude of the user's location when the travel ended.

 decimal number
added_dateutc

Readonly system field: UTC date and time this travel record was added.

 date
is_approved

is_approved flag

 boolean
is_confirmed

offline field: is_confirmed flag

 boolean
modified_dateutc

Readonly system field managed by database, filled with GetUtcDate when adding,updating

 date

Request Formats :

application/json, text/json

Sample: 
{
  "id": "8eee35b4-8a79-4805-ba10-59b6349d727d",
  "user_id": "94399ba4-a142-4fba-b793-79e8b0fa4d52",
  "car_id": "69b0f7b7-fdc1-4b90-b475-7598222b60a9",
  "from_db_address_id": "cddf2f87-fca7-49a8-a225-929c93b48b14",
  "from_db_table_id": "c189a792-7dcc-47b4-94b2-35854775ddc9",
  "from_id_in_table": "6f650641-3792-4da2-9bd8-7b677fbd6339",
  "from_travel_type_code": "sample string 7",
  "from_db_address_other": "sample string 8",
  "to_db_address_id": "7ba8258d-a1ac-4f2e-80b1-6a29d7f10083",
  "to_db_table_id": "d97ec8cf-afc2-4e01-af19-7043a45a8b09",
  "to_in_in_table": "0a32d64b-8a82-4a22-8764-de0bd6bca49d",
  "to_travel_type_code": "sample string 12",
  "to_db_address_other": "sample string 13",
  "hour_type_id": "b653f9b9-9ee7-4516-85db-38a6c79e32a9",
  "date_from": "2026-11-12T14:29:00.8698236+00:00",
  "date_from_rounded": "2026-11-12T14:29:00.8698236+00:00",
  "date_to": "2026-11-12T14:29:00.8698236+00:00",
  "date_to_rounded": "2026-11-12T14:29:00.8698236+00:00",
  "notes": "sample string 19",
  "km": 20,
  "km_before": 21,
  "km_after": 22,
  "km_private": 23,
  "km_distance": 24,
  "is_time_for_money": true,
  "is_start_stop": true,
  "property_1_checked": true,
  "property_2_checked": true,
  "property_3_checked": true,
  "property_4_checked": true,
  "property_5_checked": true,
  "start_latitude_decimal": 32.0,
  "start_longitude_decimal": 33.0,
  "end_latitude_decimal": 34.0,
  "end_longitude_decimal": 35.0,
  "added_dateutc": "2026-11-12T14:29:00.8698236+00:00",
  "is_approved": true,
  "is_confirmed": true,
  "modified_dateutc": "2026-11-12T14:29:00.8698236+00:00"
}

application/xml, text/xml

Sample: 
<car_travel xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <added_dateutc>2026-11-12T14:29:00.869Z</added_dateutc>
  <car_id>69b0f7b7-fdc1-4b90-b475-7598222b60a9</car_id>
  <date_from>2026-11-12T14:29:00.869Z</date_from>
  <date_from_rounded>2026-11-12T14:29:00.869Z</date_from_rounded>
  <date_to>2026-11-12T14:29:00.869Z</date_to>
  <date_to_rounded>2026-11-12T14:29:00.869Z</date_to_rounded>
  <end_latitude_decimal>34</end_latitude_decimal>
  <end_longitude_decimal>35</end_longitude_decimal>
  <from_db_address_id>cddf2f87-fca7-49a8-a225-929c93b48b14</from_db_address_id>
  <from_db_address_other>sample string 8</from_db_address_other>
  <from_db_table_id>c189a792-7dcc-47b4-94b2-35854775ddc9</from_db_table_id>
  <from_id_in_table>6f650641-3792-4da2-9bd8-7b677fbd6339</from_id_in_table>
  <from_travel_type_code>sample string 7</from_travel_type_code>
  <hour_type_id>b653f9b9-9ee7-4516-85db-38a6c79e32a9</hour_type_id>
  <id>8eee35b4-8a79-4805-ba10-59b6349d727d</id>
  <is_approved>true</is_approved>
  <is_confirmed>true</is_confirmed>
  <is_start_stop>true</is_start_stop>
  <is_time_for_money>true</is_time_for_money>
  <km>20</km>
  <km_after>22</km_after>
  <km_before>21</km_before>
  <km_distance>24</km_distance>
  <km_private>23</km_private>
  <modified_dateutc>2026-11-12T14:29:00.869Z</modified_dateutc>
  <notes>sample string 19</notes>
  <property_1_checked>true</property_1_checked>
  <property_2_checked>true</property_2_checked>
  <property_3_checked>true</property_3_checked>
  <property_4_checked>true</property_4_checked>
  <property_5_checked>true</property_5_checked>
  <start_latitude_decimal>32</start_latitude_decimal>
  <start_longitude_decimal>33</start_longitude_decimal>
  <to_db_address_id>7ba8258d-a1ac-4f2e-80b1-6a29d7f10083</to_db_address_id>
  <to_db_address_other>sample string 13</to_db_address_other>
  <to_db_table_id>d97ec8cf-afc2-4e01-af19-7043a45a8b09</to_db_table_id>
  <to_in_in_table>0a32d64b-8a82-4a22-8764-de0bd6bca49d</to_in_in_table>
  <to_travel_type_code>sample string 12</to_travel_type_code>
  <user_id>94399ba4-a142-4fba-b793-79e8b0fa4d52</user_id>
</car_travel>

Response Information

Resource Description :

IHttpActionResult containing the created car travel record.

IHttpActionResult

None.

Response Formats

application/json, text/json, application/xml, text/xml

Sample:

Sample not available.