---
title: "Get Scans"
method: GET
path: "/v0/scans"
tags: ["Scans"]
---

# Get Scans

`GET /v0/scans`

Search scans by various parameters.

## Query parameters

- `flight_id` string, uuid — Limit results to a specific flight ID. ID can be formatted as a full UUID, or can omit `-` characters, and is case insensitive
- `latitude` string — latitude of query point
- `longitude` string — longitude of query point
- `radius` string — radius of query (m)
- `user_id` string
- `vehicle_serial` string — Limit results to a specific vehicle, by serial number
- `scanned_before` string, date-time — Search for Scans scanned before this timestamp. The timestamp should follow the ISO 8601 standard format.
- `scanned_since` string, date-time — Search for Scans scanned since this timestamp. The timestamp should follow the ISO 8601 standard format.
- `pre_signed_download_urls` boolean — If True, the media download urls will be pre-signed, will not require authentication, and will expire after 1 hour. If False, the urls will redirect to the file and will not expire, but will still require authentication.
- `per_page` integer — Number of results to return per page
- `page_number` integer — Return a specific page number from results

## Response `200`

List of scans from GET /scans endpoint

- object
  - `data` object, required — List of scans from GET /scans endpoint
    - `pagination` object, required
      - `current_page` integer, required — Current page number of results
      - `max_per_page` integer, required — Maximum number of entries per page, could be less for final page
      - `total_pages` integer, required — Total pages of results
    - `scans` object[], required
      - `altitude` number — Altitude of the scan-volume center (m)
      - `description` string
      - `flights` object[], required
        - `attachments` object[] — (Beta) List of attachments present on the vehicle during this flight.
          - `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_serial` string
        - `flight_id` string, required
        - `has_telemetry` boolean — True if telemetry has been uploaded for this flight.
        - `landing` string, date-time
        - `markers` object[] — Markers associated with this flight, including incident/CAD IDs.
          - `incident_id` string
          - `uuid` string
        - `sensor_package` object — (Beta) The sensor package used during this flight.
          - `sensor_package_serial` string
          - `sensor_package_type` 'V100-L' | 'VT300-L' | 'VT300-Z'
        - `takeoff` string, date-time
        - `takeoff_latitude` number — Populated if telemetry has been uploaded for this flight.
        - `takeoff_longitude` number — Populated if telemetry has been uploaded for this flight.
        - `user_email` string
        - `vehicle_serial` string, required
      - `latitude` number — Location of scan-volume center
      - `longitude` number — Location of scan-volume center
      - `name` string
      - `photo_count` number
      - `scan_time` string, date-time
      - `uuid` string, required
      - `viewpoint_media_id` string
      - `viewpoint_thumbnail_url` string
  - `error_message` string
  - `meta` object, required
    - `time` number
  - `skydio_error_code` integer, required
  - `status_code` integer, required

---

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