---
title: "GET Retrieve device agent status"
description: "Retrieves the status of a specific device or all devices for a user within an organization."
last_updated: "2026-05-06T07:33:58.548557+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/device-agent/getdeviceagentstatus"
---

<APIEndpoint
  method={"GET"}
  path={"/api/device-agent/status"}
  summary={"Retrieve device agent status"}
  description={"Retrieves the status of a specific device or all devices for a user within an organization."}
  deprecated={false}
  baseUrl={""}
/>

## Parameters

<APIParameters parameters={[{"name":"deviceId","in":"query","required":false,"description":"ID of the specific device to retrieve status for.","schema":{"type":"string"}},{"name":"organizationId","in":"query","required":false,"description":"Organization ID to filter devices by.","schema":{"type":"string"}}]} />

## Responses

<APIResponse
  statusCode={"200"}
  description={"Successfully retrieved device status(es)."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"401"}
  description={"Unauthorized. User session not found."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"404"}
  description={"Device not found (when a specific deviceId is provided)."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"500"}
  description={"Failed to fetch device status."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

## Try It

<APIPlayground
  method={"GET"}
  path={"/api/device-agent/status"}
  parameters={[{"name":"deviceId","in":"query","required":false,"description":"ID of the specific device to retrieve status for.","schema":{"type":"string"}},{"name":"organizationId","in":"query","required":false,"description":"Organization ID to filter devices by.","schema":{"type":"string"}}]}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.