---
title: "Retrieving a device."
method: GET
path: "/devices/{deviceId}"
tags: ["Devices"]
---

# Retrieving a device.

`GET /devices/{deviceId}`

## Request

- Base URL: `https://api.flocksafety.com/api/v4`
- URL: `https://api.flocksafety.com/api/v4/devices/{deviceId}`
- Auth: HTTP bearer

Retrieves a particular device. Pass `include_frj=true` to also search devices shared with your organization via First Responder Jurisdiction (FRJ).

## Path parameters

- `deviceId` string, uuid, required

## Query parameters

- `include_frj` boolean

## Response `200`

The device was successfully retrieved.

- Device
  - `id` string, required: The ID of the device.
  - `type` 'camera' | 'video' | 'audio', required: The device's type.
  - `name` string, required: The name of the device.
  - `location` Location, required: The location where the device is located.
    - `latitude` number, required: The latitude of the device’s location.
    - `longitude` number, required: The longitude of the device’s location.
  - `network` Network, required: The network that the device belongs to.
    - `id` string, required: The ID for the network
    - `name` string, required: The name of the network
  - `metadata` object, required: Metadata about the device.
  - `link` string: A link to view the device in the Flock UI.
  - `organization` Organization: The organization that the device belongs to.
    - `id` string, required: The ID for the organization
    - `name` string, required: The name of the organization

## Other responses

- `401`: The provided token is either expired or invalid.
- `404`: The given device ID was not found.
- `429`: The maximum number of requests per second has been exceeded.
- `500`: An internal error happened when processing the request.

---

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