---
title: GET /agent/health
description: Operational health for agent retry/backoff decisions
full: true
---

**Auth:** none. Public health summary; the route does not read credentials.

Returns status (ok/degraded/down) + Retry-After hint + sub-probe results for the platform, orchestrator, and GPU pool. Honor Retry-After; treat 503 + degraded as transient.

## Responses

### `200` OK

Healthy

Response shape: `object`

### `503` Service Unavailable

Down — retry after the seconds returned in `recommend_retry_after_seconds`

**curl**

```bash
curl -X GET 'https://ivybiosciences.com/api/v1/agent/health'
```

**JavaScript**

```js
const res = await fetch('https://ivybiosciences.com/api/v1/agent/health', {
  method: 'GET',
});
const data = await res.json();
```

**Python**

```python
import requests

res = requests.get(
    "https://ivybiosciences.com/api/v1/agent/health",
)
data = res.json()
```
