---
title: "Get Scan by ID"
method: GET
path: "/v0/scan/{uuid}"
tags: ["Scans"]
---

# Get Scan by ID

`GET /v0/scan/{uuid}`

Fetch metadata about a single scan by its uuid.

## Path parameters

- `uuid` string, required

## Query parameters

- `files_page_number` integer — Desired page of results
- `files_per_page` integer — Number of results to return per page
- `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.

## Response `200`

Scan details and media files

- object
  - `data` object, required — Scan details and media files
    - `scan` object, required
      - `altitude` number — Altitude of the scan-volume center (m)
      - `description` string
      - `file_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
      - `files` object[], required
        - `captured_time` string, date-time
        - `download_url` string — download_url is included only if the file is uploaded. If the file is not yet uploaded the media endpoints will not return it, however it is returned as part of this response to indicate the file was captured as part of the scan.
        - `filename` string, required
        - `flight_id` string
        - `kind` 'detectionImage' | 'detectionVideoClip' | 'rtkAttachmentMrk' | 'rtkAttachmentMrkScan' | 'rtkAttachmentRinexNav' | 'rtkAttachmentRinexNavScan' | 'rtkAttachmentRinexObs' | 'rtkAttachmentRinexObsScan' | 'rtkAttachmentSbf' | 'rtkAttachmentSbfScan' | 'scanCaptureReport' | 'scanMesh' | 'scanOrthomap' | 'scanOutput' | 'scanPix4dGeolocation' | 'vehicleImage' | 'vehicleImageDng' | 'vehicleIrImage' | 'vehicleRadiometricImage' | 'vehicleVideoPreview' | 'vehicleVideoRaw' | 'videoTelemetryCsv', required
        - `mission_template_uuid` string
        - `mission_waypoint_name` string — The name of the waypoint where the media was captured.
        - `sha256` string
        - `size` integer — File size in bytes
        - `uploaded_time` string, date-time
        - `user_id` string
        - `uuid` string, required
      - `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

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