# Check API status

Source: https://help.ruuster.com/api/status

```http
GET https://api.ruuster.com/v1/status
```

Whether the API is up. Needs no authentication; use it for uptime monitors.

- Authentication: none

Returns `status` (`operational` or `maintenance`), `version` and `time`. It's a health signal for your monitors, not a status page. During maintenance, other calls return `503 api_paused`.

## Example request

cURL:

```bash
curl -s "https://api.ruuster.com/v1/status"
```

Node.js:

```javascript
const res = await fetch("https://api.ruuster.com/v1/status");
const body = await res.json();
if (!body.ok) throw new Error(`${body.error.code}: ${body.error.message} (${body.requestId})`);
console.log(body.data);
```

Python:

```python
import requests

res = requests.get(
    "https://api.ruuster.com/v1/status",
    timeout=30,
)
body = res.json()
if not body["ok"]:
    raise RuntimeError(f'{body["error"]["code"]}: {body["error"]["message"]} ({body.get("requestId")})')
print(body["data"])
```

## Example response

```json
{ "ok": true, "data": { "status": "operational", "version": "1.0.0", "time": "2026-10-01T14:02:11Z" } }
```
