---
title: "Get single Agent's status"
method: GET
path: "/api/v1/agents/{agentId}/status"
tags: ["Agents"]
---

# Get single Agent's status

`GET /api/v1/agents/{agentId}/status`

## Path parameters

- `agentId` integer, required

## Response `200`

OK

- DtoAgentStatusGetResponse
  - `data` DtoAgentStatusGet
    - `url` string — The hostname or address for the agent. Can either be full URL https://example.org:1234 or hostname subdomain.example.org
    - `httpPorts` string[] — List of http ports the Agent listens to. If the Url is a full address (schema://hostname:port?) this can be ignored.
    - `httpsPorts` string[] — List of https ports the Agent listens to. If the Url is a full address (schema://hostname:port?) this can be ignored.
    - `id` integer — Agent Identifier
    - `name` string — Agent name
    - `isGateway` boolean — If the agent is a Gateway Agent. If true, these Agents are the ones that should primarily be accessible from the internet.
    - `isCloudAgent` boolean — If the agent is a Cloud Agent. If true, these Agents are managed by Frends.
    - `lastError` string, date-time, nullable — Date&Time of the last error occurred.
    - `lastUpdate` string, date-time, nullable — Date&Time of the last agent update occurred.
    - `lastStatus` string, nullable — Last known Agent status.

## Other responses

- `404` — Agent not found

---

[API](https://skmtc.dev/frends/apis/frends-api.md) · [All operations](https://skmtc.dev/frends/apis/frends-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/frends/frends-api/revisions/cf4c0a0d1c8a/schema)