---
title: "List your apps"
method: GET
path: "/apps"
tags: ["Apps"]
---

# List your apps

`GET /apps`

## Request

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

## Response `200`

Every app you own, oldest first.

- object
  - `apps` object[], 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
    - `dashboardUrl` string
    - `openIncidents` integer

## Other responses

- `401`: No token, or not a valid one.
- `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)