---
title: "An app's health right now"
method: GET
path: "/apps/{appId}"
tags: ["Apps"]
---

# An app's health right now

`GET /apps/{appId}`

## Request

- Base URL: `https://app.getvigilia.com/v1`
- URL: `https://app.getvigilia.com/v1/apps/{appId}`
- Auth: HTTP bearer

Uptime, open incidents by severity, today's events and this month's AI diagnosis budget.

## Path parameters

- `appId` string, required

## Response `200`

The app and its health.

- object
  - `app` AppHealth, required
    - `id` string
    - `name` string
    - `url` string
    - `builder` 'lovable' | 'bolt' | 'v0' | 'cursor' | 'claude-code' | 'replit' | 'other'
    - `createdAt` integer
    - `installed` boolean: Vigilia has received at least one event.
    - `withinPlan` boolean: False for an app beyond the plan's app limit: it records, but isn't diagnosed.
    - `uptime` object
      - `status` 'up' | 'down' | 'unknown'
      - `lastCheckedAt` integer, nullable
      - `lastDownAt` integer, nullable
      - `uptimePercentLastHour` number, nullable
    - `dashboardUrl` string
    - `openIncidents` object
      - `total` integer
      - `critical` integer
      - `high` integer
      - `medium` integer
      - `low` integer
    - `events` object
      - `today` integer
      - `total` integer
      - `lastEventAt` integer, nullable
    - `aiDiagnoses` object: This month's budget of AI diagnoses for the app. On Free it's the allowance; on paid plans, a fair-use ceiling.
      - `used` integer
      - `limit` integer
      - `remaining` integer
      - `resetsAt` integer
      - `kind` 'allowance' | 'fair-use'

## Other responses

- `401`: No token, or not a valid one.
- `404`: No such thing on your account.
- `429`: Too many requests for this token (`rate_limited`), or a Free account's daily requests are used up (`daily_limit`) — wait `Retry-After` seconds.

---

[API](https://skmtc.dev/getvigilia/apis/vigilia-api.md) · [All operations](https://skmtc.dev/getvigilia/apis/vigilia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getvigilia/apis/vigilia-api/revisions/43dd51b3e83a?raw)