# Идут ли плановые работы

`GET https://api.souz.ai/v1/status`

Без ключа. `ok` — сервис работает; `maintenance` — плановые работы: новые запросы
(`POST`, `PUT`, `PATCH`, `DELETE`) до `ends_at` получают `503 maintenance`, принятые
задачи доделываются после, чтение и опрос задач работают. Отвечает и тогда, когда сам
API остановлен на время работ.

## Пример запроса

```bash
curl -X GET 'https://api.souz.ai/v1/status'
```

```python
import requests

response = requests.get(
    "https://api.souz.ai/v1/status",
)
print(response.json())
```

```ts
const response = await fetch("https://api.souz.ai/v1/status", {
  method: "GET",
});
console.log(await response.json());
```

## Ответы

### 200

Состояние; не кешируется (`Cache-Control: no-store`).

- `application/json`, схема `ServiceStatus`

```json
{
  "ends_at": "2026-10-04T14:15:00+03:00",
  "reason": "Обновление сервиса",
  "started_at": "2026-10-04T14:00:00+03:00",
  "status": "maintenance"
}
```

### 503

Сервис не отвечает, а плановых работ нет — `{"status": "unavailable"}`: сбой, мы уже чиним; повторите позже.

- `application/json`

```json
{
  "status": "unavailable"
}
```

---

Оглавление документации: https://souz.ai/llms.txt. Всё руководство одним файлом: https://souz.ai/llms-full.txt. Справочник методов: https://souz.ai/docs/api-reference.md.