# List cameras

List all claimed cameras in the fleet along with the organisations that own them.

Endpoint: GET /cameras
Version: 0.0.1
Security: o_auth

## Query parameters:

  - `includeMetrics` (boolean)
    Choose whether camera metrics should be included in the response or not.

  - `siteId` (string)
    The ID of the site whose list of associated cameras will be returned.

  - `userId` (string)
    The ID of a user on whose visibility of the cameras to filter on.

  - `state` (array)
    The camera states to filter on.
    Enum: "running", "paused", "decommissioned"

## Response 200 fields (application/json):

  - `cameraPositionId` (string)

  - `claimedAt` (string)

  - `direction1Alias` (string)

  - `direction2Alias` (string)

  - `encodedFramesProportion` (number,null)
    The number of frames encoded over the expected number of frames in the last 2 minutes.

  - `id` (string)

  - `isOnline` (boolean,null)

  - `lastSeenAt` (string,null)

  - `lastVideoAt` (string,null)

  - `name` (string)

  - `networkTransmitRate` (number,null)
    The rate in bytes/second the camera sends information over the network at.

  - `organisationId` (string)

  - `serialNumber` (string)

  - `siteId` (string)

  - `state` (string)
    Enum: "running", "decommissioned", "paused"

  - `videoBacklog` (number,null)
    The number of milliseconds of video the camera is waiting to upload.

  - `videoUploadLatency` (number,null)
    The number of milliseconds it took the latest video uploaded to be uploaded.

## Response 401 fields (application/json):

  - `code` (integer)

  - `message` (string)

## Response 403 fields (application/json):

  - `code` (integer)

  - `message` (string)

## Response 422 fields (application/json):

  - `code` (integer)

  - `message` (string)


## Response 500 fields