# Dependency readiness

URL: https://docs.healthcare.dev/reference/service/dependency-readiness

```http
GET https://api.healthcare.dev/readyz
```

Returns 200 when the database and cache are reachable, 503 otherwise.

Public: no API key needed.

## Examples

**curl**

```sh
curl "https://api.healthcare.dev/readyz"
```

**TypeScript**

```ts
const res = await fetch("https://api.healthcare.dev/readyz");
const { data, meta } = await res.json();
```

**Python**

```python
import requests

res = requests.get("https://api.healthcare.dev/readyz")
body = res.json()
```

## Response

Ready

```json
{
  "status": "ok",
  "checks": {}
}
```

### Fields

| Field | Type | Always present | Description |
| --- | --- | --- | --- |
| `status` | "ok" \| "degraded" | yes |  |
| `checks` | object | yes |  |

## Errors

Errors are `application/problem+json` ([RFC 9457](https://www.rfc-editor.org/rfc/rfc9457)). Branch on `type`, not on `title`. See [Errors](/errors).

| Status | `type` | When |
| --- | --- | --- |
| 503 | `dataset-unavailable / unavailable` | The dataset has no published version yet, or the service is degraded. |