---
title: "Retrieve All Tracked Subjects"
method: GET
path: "/geo/subjects"
tags: ["Tracked Subjects"]
---

# Retrieve All Tracked Subjects

`GET /geo/subjects`

Get all subjects' current locations

## Query parameters

- `since` integer
- `page` integer
- `subjectType` 'vehicle' | 'person' | 'drone' | 'other'
- `subjectSubtype` string
- `showInactive` boolean

## Response `200`

Get all subjects' current locations

- Heartbeat[]
  - `subjectId` string — ID of the subject in flocks system
  - `subjectType` 'vehicle' | 'person' | 'drone' | 'other', required — base type of the subject. This is used to filter subjects on the map
  - `subjectSubtype` string, required — subtype of the subject. This is used to filter subjects on the map
  - `externalId` string, required — ID of the subject in your system. Must be unique per organization.
  - `createdAt` string, date-time — RFC3339 UTC datetime string of when subject was created
  - `updatedAt` string, date-time — RFC3339 UTC datetime string of when subject was last updated. Use this if different time than createdAt or the current time.
  - `disableAt` string, date-time — RFC3339 UTC datetime string of when subject should be inactive
  - `latitude` number, required
  - `longitude` number, required
  - `altitude` number — altitude in meters, defaults to 0.0 and returned as 0.0 if not provided
  - `additionalMetadata` object — flat json object, defaults to {} and returned as {} if not provided
    - `type` 'string' | 'number' | 'boolean' — What type the value of the metadata value is
    - `value` object — value of the metadata. Must be a string, number, or boolean
  - `deviceLink` string — URL to the device, defaults to "" and returned as "" if not provided
  - `deviceStatus` string — status of the device such as buffering, recording, etc
  - `isRecording` boolean — if the subject is recording or not
  - `nickname` string — nickname of the subject
  - `isLawEnforcement` boolean — if the subject is a law enforcement subject or not

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/flocksafety/apis/oauth-api.md) · [All operations](https://skmtc.net/flocksafety/apis/oauth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flocksafety/oauth-api/revisions/126df7964ba5/schema)