---
title: "Check if an agent is online (public)"
method: GET
path: "/v1/agent/ping/{did}"
tags: ["Agent Infrastructure"]
---

# Check if an agent is online (public)

`GET /v1/agent/ping/{did}`

Returns online/idle/offline status based on last_seen. Online = <5min, Idle = <30min, Offline = 30min+.

## Path parameters

- `did` string, required

## Response `200`

Online status

- object
  - `did` string
  - `name` string, nullable
  - `online_status` 'online' | 'idle' | 'offline'
  - `minutes_since_seen` integer, nullable
  - `uptime_days` integer

## Other responses

- `404` — Agent not found

---

[API](https://skmtc.net/voidly/apis/voidly-api.md) · [All operations](https://skmtc.net/voidly/apis/voidly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voidly/voidly-api/versions/decbe6fd40a8/schema)