> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Controllo di stato

> Verifica pubblica di disponibilità per il monitoraggio dell'uptime

Un readiness probe pubblico per il monitoraggio esterno dell'uptime. È l'unico endpoint che **non richiede autenticazione**: non inviare l'header `x-api-key`.

> [!NOTE]
>
> Per lo stato operativo in tempo reale, il dettaglio dei singoli servizi e lo storico degli
> incidenti, consulta la nostra pagina [Stato del sistema](https://docs.anivahealth.com/it/status.md).

Il controllo è un readiness probe, non solo un liveness ping: verifica che il processo API sia attivo **e** che il suo database sia raggiungibile. Se il database non è raggiungibile, l'endpoint restituisce `503` così un sistema di monitoraggio non segnala mai l'API come operativa quando non può servire le richieste dei partner.

Le risposte vengono inviate con `Cache-Control: no-store`, così ogni richiesta raggiunge l'origine invece di una risposta edge in cache.

## Richiesta

Questo endpoint non richiede parametri né autenticazione.

## Risposta

In caso di successo l'API restituisce `200 OK`. Quando il database non è raggiungibile restituisce `503 Service Unavailable` con la stessa struttura del body.

**status** `"ok" | "error"` *required*

`ok` quando il servizio e il suo database sono raggiungibili, altrimenti `error`.

**timestamp** `string` *required*

Istante UTC in formato ISO 8601 in cui è stato eseguito il controllo (ad es. `2026-06-27T08:30:00.000Z`).

## Codici di stato

| Stato | Descrizione |
| - | - |
| `200` | Servizio e database sono raggiungibili. |
| `503` | Il servizio non è operativo: il database non è raggiungibile. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/health'
```

```json 200 theme={null}
{
  "status": "ok",
  "timestamp": "2026-06-27T08:30:00.000Z"
}
```

```json 503 theme={null}
{
  "status": "error",
  "timestamp": "2026-06-27T08:30:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.