---
title: "[beta] List fleet installer photo uploads."
method: GET
path: "/fleet/installer/photo-uploads"
tags: ["Beta APIs"]
---

# \[beta\] List fleet installer photo uploads.

`GET /fleet/installer/photo-uploads`

## Request

- Base URL: `https://api.samsara.com`
- URL: `https://api.samsara.com/fleet/installer/photo-uploads`
- Auth: HTTP bearer

Returns fleet installer photo upload sessions for the caller's org. Results are ordered by updatedAtTime ascending and paginated (up to 25 per page). Supports filtering by session IDs, startTime, and endTime. Omitting startTime returns all sessions for the org. endTime requires startTime.

 <b>Rate limit:</b> 100 requests/min (learn more about rate limits <a href="https://developers.samsara.com/docs/rate-limits" target="_blank">here</a>).

To use this endpoint, select **Read Devices** under the Devices category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>
 

 **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

## Query parameters

- `ids` string[]
- `startTime` string
- `endTime` string
- `after` string

## Response `200`

OK response.

- FleetInstallerPhotoUploadsGetFleetInstallerPhotoUploadsResponseBody
  - `data` FleetInstallerPhotoUploadSessionResponseBody[], required: Upload sessions ordered by updatedAtTime ascending. Up to 25 results per page.
    - `contentMd5` string, required: Base64-encoded MD5 of the file bytes.
    - `createdAtTime` string, date-time, required: Session creation timestamp (RFC 3339).
    - `deviceId` string, required: Samsara device ID.
    - `fileFormatType` 'imageJpeg' | 'imagePng' | 'unknown', required: File format. Valid values: `imageJpeg`, `imagePng`, `unknown`
    - `fileName` string, required: Original file name supplied at session creation.
    - `hardwareType` 'vehicleGateway' | 'assetGateway' | 'camera' | 'cameraConnector' | 'environmentalMonitor' | 'assetTag' | 'trackingLabel' | 'unknown', required: Hardware category of the device. Valid values: `vehicleGateway`, `assetGateway`, `camera`, `cameraConnector`, `environmentalMonitor`, `assetTag`, `trackingLabel`, `unknown`
    - `id` string, required: Unique session UUID.
    - `photoType` 'installPhoto' | 'assetPhoto' | 'unknown', required: Purpose of the photo. Valid values: `installPhoto`, `assetPhoto`, `unknown`
    - `processingStatus` 'awaitingUpload' | 'processing' | 'finished' | 'unknown', required: Upload lifecycle state. Valid values: `awaitingUpload`, `processing`, `finished`, `unknown`
    - `sizeBytes` integer, required: File size in bytes.
    - `updatedAtTime` string, date-time, required: Timestamp of last state change (RFC 3339). Equals createdAtTime at session creation; updated when processingStatus changes.
  - `pagination` GoaPaginationResponseResponseBody, required: Pagination parameters.
    - `endCursor` string, required: Cursor identifier representing the last element in the response. This value should be used in conjunction with a subsequent request's 'after' query parameter. This may be an empty string if there are no more pages left to view.
    - `hasNextPage` boolean, required: True if there are more pages of results immediately available after this endCursor.

## Other responses

- `401`: Unauthorized response.
- `404`: Not Found response.
- `405`: Method Not Allowed response.
- `413`: Content Too Large response.
- `429`: Too Many Requests response.
- `500`: Internal Server Error response.
- `501`: Not Implemented response.
- `502`: Bad Gateway response.
- `503`: Service Unavailable response.
- `504`: Gateway Timeout response.
- `default`: Bad Request response.

---

[API](https://skmtc.dev/samsara/apis/samsara-api.md) - [All operations](https://skmtc.dev/samsara/apis/samsara-api/llms.txt) - [OpenAPI document](https://skmtc.dev/samsara/apis/samsara-api/revisions/a9e35d4999be?raw)