---
title: "How the database is doing"
method: GET
path: "/client/apps/{id}/database/health"
tags: ["App data"]
---

# How the database is doing

`GET /client/apps/{id}/database/health`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/client/apps/{id}/database/health`
- Auth: HTTP bearer

Charts, notices and tables for the app’s managed database: connection wait, connections in use against the limit, errors, response time and queries per second, as hour buckets (`?hours=`, up to 168) or day buckets (`?days=`, up to 730) — send one, not both. Also errors by SQLSTATE code over the same range (summing to the buckets’ error lines), the latest stuck-query reading, this month’s uptime, notices for anything wrong right now, and the incident log. Null means not measured, never zero. No query text or row data. Requires `apps:read`.

## Path parameters

- `id` string, uuid, required

## Response `200`

Database health report. (Response shape not yet modelled in this spec.)

- object

## Other responses

- `400`: Both ranges, or one past what is kept
- `404`: No such app for you

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)