Get trips

Gets trips that a user has access to. The trips are always ordered by their ending timestamp, newest one first. Use a limit query parameter to bound the number of trips returned.

GET /trip

Get trips

cURL

curl --request GET \
  --url https://ctechnology.io/api/v2.2/trip \
  --header 'Authorization: <api-key>'

import requests

url = "https://ctechnology.io/api/v2.2/trip"

headers = {"Authorization": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://ctechnology.io/api/v2.2/trip', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ctechnology.io/api/v2.2/trip",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://ctechnology.io/api/v2.2/trip"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://ctechnology.io/api/v2.2/trip")
  .header("Authorization", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ctechnology.io/api/v2.2/trip")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "header": {
    "num_results": 123,
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ],
    "offset": 123,
    "limit": 123
  },
  "data": [
    {
      "id": "<string>",
      "vehicle_id": "<string>",
      "timestamp_start": "2023-11-07T05:31:56Z",
      "timestamp_end": "2023-11-07T05:31:56Z",
      "completed": true,
      "deleted": true,
      "valid": true,
      "validation_score": 123,
      "name": "<string>",
      "driver": "<string>",
      "image_rect_url": "<string>",
      "speed_max": 123,
      "speed_avg": 123,
      "distance_tot": 123,
      "distance_tot_gps": 123,
      "duration_tot": 123,
      "duration_cruising": 123,
      "battery_start_level_volt": 123,
      "battery_end_level_volt": 123,
      "num_likes": 123,
      "timestamp_original_start": "2023-11-07T05:31:56Z",
      "timestamp_original_end": "2023-11-07T05:31:56Z",
      "on_land": true,
      "notes": "<string>",
      "fuel_manual_lt": 123,
      "distance_tot_can": 123,
      "distance_tot_odo": 123,
      "fuel_start_level_pct": 123,
      "fuel_start_level_lt": 123,
      "fuel_most_recent_pct": 123,
      "fuel_most_recent_vlt": 123,
      "fuel_used_pct": 123,
      "fuel_used_lt": 123,
      "fuel_num_refueled": 123,
      "fuel_refueled_pct": 123,
      "fuel_refueled_lt": 123,
      "fuel_avg_lt_per_100km": 123,
      "fuel_avg_pct_per_100km": 123,
      "start_energy_available_ah": 123,
      "end_energy_available_ah": 123,
      "continuous_energy_consumption_ah": 123,
      "start_energy_available_wh": 123,
      "end_energy_available_wh": 123,
      "continuous_energy_consumption_wh": 123,
      "start_energy_available_pct": 123,
      "end_energy_available_pct": 123,
      "continuous_energy_consumption_pct": 123,
      "n2k_operation_hours_tot": 123,
      "can_fuel_consumption_avg": 123,
      "can_fuel_consumption_max": 123,
      "can_fuel_consumption_tot": 123,
      "can_rpm_max": 123,
      "can_rpm_avg": 123,
      "is_liked_by_me": true
    }
  ]
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

{
  "header": {
    "api_version": "<string>",
    "status": "<string>",
    "message": "<string>",
    "permission_via": [
      {
        "permission": "<string>",
        "organization_id": "<string>"
      }
    ]
  },
  "error": {
    "id": "<string>",
    "status": 123,
    "type": "<string>",
    "message": "<string>",
    "message_i18n": "<string>",
    "data": {}
  }
}

Authorizations

Authorization · string · header · required

Note that the API key has to be sent as Token 123 where 123 is the key you received after logging in or by creating on the developer dashboard.

Query Parameters

to · string<date-time>

Up until when to get the trips.

limit · number

The number of trips to return.

scope · enum<string>

The scope, publicly shared trips or a user's private ones. The visibility scope of trips, actions, etc.

Available options: PUBLIC, PRIVATE

Response

200

application/json

Successful retrieval of trips.

header · API Header Paginated · object · required

Default header sent along with multi-resource responses (lists of resources).

Show child attributes

data · Trip · object[] · required

Show child attributes