---
title: "Get Vehicle by Serial"
method: GET
path: "/v0/vehicle/{vehicle_serial}"
tags: ["Vehicles"]
---

# Get Vehicle by Serial

`GET /v0/vehicle/{vehicle_serial}`

Fetch metadata about a single vehicle by its serial.

## Path parameters

- `vehicle_serial` string, required

## Response `200`

Vehicle returned from GET /vehicle endpoint

- object
  - `data` object, required — Vehicle returned from GET /vehicle endpoint
    - `vehicle` object, required
      - `attachments` object[] — List of attachments present on the vehicle.
        - `attachment_serial` string
        - `attachment_type` 'SPOTLIGHT' | 'NIGHTSENSE' | 'SPEAKER_AND_MIC' | 'DROPPER' — Type of attachment on the vehicle
        - `mount_point` 'TOP' | 'BOTTOM' | 'LEFT' | 'RIGHT' — Location of the attachment on the vehicle
      - `battery_status` object — Information about the vehicle's battery. Only populated if vehicle is online
        - `charging` boolean
        - `percentage` number
      - `device_health_status` 'No Known Issues' | 'Limited Operation' | 'Inoperable' | 'Out of Service' | 'Unknown' — Overall health status of the vehicle.
      - `dock` object — Information about the vehicle's linked dock. Only populated if vehicle is linked to a dock.
        - `dock_serial` string
        - `dock_type` 'DOCK' | 'DOCK_LITE' | 'X10_DOCK'
      - `flight_status` 'FLYING' | 'POST_FLIGHT' | 'PREP' | 'REST' | 'UNKNOWN'
      - `is_live_streaming` boolean — Whether or not the vehicle is streaming video
      - `is_online` boolean — Whether or not the vehicle has a direct connection to the internet.
      - `is_online_via_mobile` boolean — Whether or not the vehicle is connected to the internet via a connected mobile device.
      - `mission_status` object — Information about the current mission and next scheduled mission on the vehicle
        - `current_mission` object
          - `mission_name` string
          - `mission_template_uuid` string, uuid, required
          - `seconds_until_takeoff` integer
          - `state` 'IN_PROGRESS' | 'PAUSED' | 'POST_MISSION_ACTION'
        - `next_scheduled_mission` object
          - `mission_name` string
          - `mission_template_uuid` string, uuid, required
          - `seconds_until_takeoff` integer
          - `state` 'IN_PROGRESS' | 'PAUSED' | 'POST_MISSION_ACTION'
      - `name` string — The display name / nickname for the vehicle. Defaults to vehicle serial.
      - `remote_stream_state` 'disabled' | 'pending' | 'active' | 'blocked' | 'device_offline' | 'device_unsupported'
      - `sensor_package` object — Information about the vehicle's linked sensor package. Only populated if vehicle is linked to a sensor package.
        - `sensor_package_serial` string
        - `sensor_package_type` 'V100-L' | 'VT300-L' | 'VT300-Z'
      - `upload_status` object — Information about the file uploads on the vehicle. Only populated if vehicle is online
        - `files_to_upload` integer
        - `uploading` boolean
      - `user_emails` string[], required — Users that have flown this vehicle.
      - `vehicle_class` 'Skydio R1' | 'Skydio 2' | 'Skydio X2' | 'Skydio X10' | 'Skydio R10', required
      - `vehicle_serial` string, required
      - `vehicle_type` 'R1' | 'R3' | 'E1' | 'X10' | 'R10'
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/skydio/apis/skydio-cloud-api.md) · [All operations](https://skmtc.net/skydio/apis/skydio-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skydio/skydio-cloud-api/revisions/0f746b116483/schema)