--- title: "Get summary of an ended trip" method: GET path: "/skynet/trip/{id}/summary" tags: ["Tracking_Trip"] --- # Get summary of an ended trip `GET /skynet/trip/{id}/summary` ## Path parameters - `id` string, required ## Query parameters - `key` string, 32 character alphanumeric string, required ## Response `200` - object - `status` string — A string indicating the state of the response. On successful responses, the value will be Ok. Indicative error messages are returned for different errors. See the [API Error Codes](#api-error-codes) section below for more information. - `message` string — Displays the error message in case of a failed request. If the request is successful, this field is not present in the response. - `data` object — An container for the trip returned by the service. - `trip` TripSummaryResponse — An object containing the returned trip summary. - `id` string — Returns the unique identifier of the trip. - `asset_id` string — Returns the ID of the asset linked to the trip when the trip was started or updated. - `state` string — Returns the current state of the trip. The value will be "active" if the trip is still going on, otherwise the value returned would be "ended". - `name` string — Returns the name for the trip as provided at the time of starting or updating the trip. - `description` string — Returns the custom description for the trip as provided at the time of starting or updating the trip. - `meta_data` object — Returns the metadata containing additional information about the trip as provided at the time of starting or updating the trip. - `attributes` object — Returns the attributes provided for the trip at the time of starting or updating it. - `started_at` integer — Returns the time, expressed as UNIX epoch timestamp in milliseconds, when the trip started. - `ended_at` integer — Returns the time, expressed as UNIX epoch timestamp in milliseconds, when the trip ended. - `created_at` integer — Returns the time, expressed as UNIX epoch timestamp in milliseconds, when the trip was created. - `updated_at` integer — Returns the timeme, expressed as UNIX epoch timestamp in milliseconds, when the trip was last updated. - `stops` TripStop[] — An array of objects returning the details of the stops made during the trip. Each object represents a single stop. - `name` string — Returns the name of the stop that was provided when configuring this stop for the trip. - `meta_data` object — Returns any meta data that was added to provide additional information about the stop. - `geofence_id` string — Returns the ID of the geofence that was used to indicate the area to make a stop. - `route` DtoTrackLocation[] — An array of object returning the details of the locations tracked for the asset during the trip which has ended. Each object represents a single location that was tracked. Please note that this attribute will not be present in the response if no locations were tracked/uploaded during the trip. - `accuracy` number — If available, this property returns the accuracy of the GPS information received at the tracked location. It is represented as an estimated horizontal accuracy radius, in meters, at the 68th percentile confidence level. - `altitude` number — If available in the GPS information, this property returns the altitude of the asset at the tracked location. It is represented as height, in meters, above the WGS84 reference ellipsoid. - `bearing` number — If available in the GPS information, this property returns the heading of the asset calculated from true north in clockwise direction at the tracked location. Please note that the bearing is not affected by the device orientation. The bearing will always be in the range of [0, 360). - `location` object — An object with the coordinates of the last tracked location. - `lat` number — Latitude of the tracked location of the asset. - `lon` number — Longitude of the tracked location of the asset. - `meta_data` TrackMetaDataSkynet — Specifies the custom data about the location that was added when the location was uploaded. - `speed` number — If available in the GPS information, this property returns the speed of the asset, in meters per second, at the tracked location. - `timestamp` integer — A UNIX epoch timestamp in milliseconds, representing the time at which the location was tracked. - `battery_level` integer — Returns the battery level of the GPS device, as a percentage, when the location was tracked. It has a minimum value of 0 and a maximum value of 100. - `tracking_mode` string — Internal parameter for tracking mode. - `asset` DtoAssetDetails — An object with details of the asset properties. - `id` string — ID of the asset. This is the same ID that was generated/provided at the time of creating the asset. - `device_id` string — ID of the device that is linked to this asset. Please note that there can be multiple device_id linked to a single asset. An empty response is returned if no devices are linked to the asset. User can link a device to an asset using the *Bind Asset to Device* method. - `state` string — State of the asset. It will be "active" when the asset is in use or available for use, and it will be "deleted" in case the asset has been deleted. - `name` string — Name of the asset. The value would be the same as that provided for the name parameter at the time of creating or updating the asset. - `description` string — Description of the asset. The value would be the same as that provided for the description parameter at the time of creating or updating the asset. - `meta_data` MetaData — Any valid json object data. Can be used to save customized data. Max size is 65kb. - `created_at` integer — A UNIX epoch timestamp in seconds representing the time at which the asset was created. - `updated_at` integer — A UNIX epoch timestamp in seconds representing the time at which the asset was last updated. - `tracked_at` integer — A UNIX epoch timestamp in seconds representing the last time when the asset was tracked. - `attributes` object — A string dictionary object containing attributes of the asset. These attributes were associated with the asset at the time of creating or updating it. attributes can be added to an asset using the *Update Asset Attributes* method. - `latest_location` object — An object with details of the last tracked location of the asset. - `location` object — An object with the coordinates of the last tracked location. - `lat` number — Latitude of the tracked location of the asset. - `lon` number — Longitude of the tracked location of the asset. - `timestamp` integer — A UNIX epoch timestamp in milliseconds, representing the time at which the location was tracked. - `accuracy` number — If available, this property returns the accuracy of the GPS information received at the last tracked location. It is represented as an estimated horizontal accuracy radius, in meters, at the 68th percentile confidence level. - `speed` number — If available in the GPS information, this property returns the speed of the asset, in meters per second, at the last tracked location. - `bearing` number — If available in the GPS information, this property returns the heading of the asset calculated from true north in clockwise direction at the last tracked location. Please note that the bearing is not affected by the device orientation. The bearing will always be in the range of [0, 360). - `altitude` number — If available in the GPS information, this property returns the altitude of the asset at the last tracked location. It is represented as height, in meters, above the WGS84 reference ellipsoid. - `tags` string[] — **This parameter will be deprecated soon! Please move existing tags to attributes parameter.** Tags of the asset. These were associated with the asset when it was created or updated. tags can be used for filtering assets in operations like *Get Asset List* and asset **Search** methods. They can also be used for monitoring of assets using **Monitor** methods after linking tags and asset. - `geometry` string[] — Returns the geometry of the route that was taken during the trip, encoded in polyline format. Please note that this field will be available in the response only if a minimum of 3 locations were tracked during the trip. - `distance` number — Returns the total distance covered during the trip, in meters. Please note that this field will be available in the response only if a minimum of 3 locations were tracked during the trip. - `duration` number — Returns the total duration elapsed during the trip, in seconds. Please note that this field will be available in the response only if a minimum of 3 locations were tracked during the trip. ## Other responses - `404` --- [API](https://skmtc.net/nextbillion-ai/apis/one-spec-service.md) · [All operations](https://skmtc.net/nextbillion-ai/apis/one-spec-service/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextbillion-ai/one-spec-service/versions/b647f1808dda/schema)