---
title: "Up Lookup"
method: GET
path: "/v1/up/{host}"
---

# Up Lookup

`GET /v1/up/{host}`

## Request

- Base URL: `https://api.ned.watch` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ned.watch/v1/up/{host}`
- Auth: none declared

v1.15 'ask before you call': the state of everything Ned watches publicly on a host (and its subdomains), no key.
state is the worst of them: down, degraded, reachable, up, or unknown when nothing on The Watch matches (then
watch_this says how to add it). One station's view, cached 20 s; ask the other station too if it matters.

## Path parameters

- `host` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ned/apis/ned-watch.md) · [All operations](https://skmtc.dev/ned/apis/ned-watch/llms.txt) · [OpenAPI document](https://skmtc.dev/ned/apis/ned-watch/revisions/6cc545e782d4?raw)