---
title: "Get a single trip"
method: GET
path: "/skynet/trip/{id}"
tags: ["Tracking_Trip"]
---

# Get a single trip

`GET /skynet/trip/{id}`

Retrieves detailed information about a specific trip.

## Path parameters

- `id` string, required

## Query parameters

- `key` string, 32 character alphanumeric string, required

## Response `200`

Detailed trip data

- 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` Trip — An object containing the returned trip details.
      - `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.

## 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)