---
title: "Get Application Overview"
method: GET
path: "/apps/{appId}/overview"
tags: ["Applications"]
---

# Get Application Overview

`GET /apps/{appId}/overview`

## Request

- Base URL: `https://api.bunny.net/mc`
- URL: `https://api.bunny.net/mc/apps/{appId}/overview`
- Auth: API key in header `AccessKey`
- TypeScript: <https://skmtc.dev/bunny/apis/magic-containers-api/docs/apps/:appId/overview/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves comprehensive status overview for an application including latency, CPU/RAM usage, active instances, regions, and cost information.

## Path parameters

- `appId` string, required

## Response `200`

Application status overview was successfully retrieved.

- Overview: Application overview model
  - `targetLatency` DoubleStatusIndicator: Status grade model
    - `indicator` number, double
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `currentLatency` DoubleStatusIndicator: Status grade model
    - `indicator` number, double
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `activeRegions` Int32StatusIndicator: Status grade model
    - `indicator` integer
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `activeInstances` Int32StatusIndicator: Status grade model
    - `indicator` integer
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `desiredInstances` integer
  - `status` 'unknown' | 'active' | 'progressing' | 'inactive' | 'failing' | 'suspended'
  - `averageCPU` DoubleStatusIndicator: Status grade model
    - `indicator` number, double
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `averageRAM` DoubleStatusIndicator: Status grade model
    - `indicator` number, double
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `averageVolumesUsage` DoubleStatusIndicator: Status grade model
    - `indicator` number, double
    - `statusGrade` 'couldBeBetter' | 'notBad' | 'doingGreat'
  - `regions` OverviewRegion[]
    - `region` string
    - `isRequired` boolean
    - `instances` integer
    - `status` 'unknown' | 'active' | 'progressing' | 'inactive' | 'failing'
    - `averageCPU` number, double
    - `averageRAM` number, double
    - `averageVolumesUsagePercentage` number, double
    - `requests` number, double
    - `anycastTraffic` number, double
    - `pods` OverviewPod[]
      - `name` string
      - `status` 'notScheduled' | 'scheduled' | 'ready' | 'deleting'
      - `lastHeartBeat` string, date-time, nullable
      - `outboundTrafficChart` object, nullable
      - `cpuUsage` number, double
      - `ramUsage` number, double
      - `containers` OverviewContainer[]
        - `id` string
        - `name` string
        - `cpuUsage` number, double
        - `ramUsage` number, double
        - `reason` string
        - `message` string
        - `status` 'notStarted' | 'started' | 'ready'
        - `image` string, nullable
        - `imageDisplay` string, nullable
        - `numberOfRestarts` integer, nullable
        - `exitCode` integer, nullable
      - `message` string, nullable
      - `volumesUtilizationPercentage` object
      - `ephemeralStorageUsageBytes` integer, nullable
      - `ephemeralStorageLimitBytes` integer, nullable
      - `ephemeralStorageUsageRatio` number, double, nullable
      - `outboundConnectionsLimit` integer, nullable
      - `outboundConnectionsRejectedDiff` integer, nullable
      - `cpuUsageCores` number, double, nullable
      - `ramUsageBytes` number, double, nullable
      - `outboundBandwidthBytesPerSecond` number, double, nullable
      - `volumes` OverviewPodVolume[], nullable
        - `id` string
        - `usageBytes` number, double
        - `sizeBytes` number, double
  - `averageLatency` number, double
  - `totalVolumeSizeInGb` number, double
  - `monthlyCost` number, double
  - `latencyChart` object
  - `limits` OverviewLimits: What one instance of the application may use. The same for every instance, so it is stated once.
    - `cpuCores` number, double, nullable
    - `ramBytes` number, double, nullable
    - `outboundBandwidthBytesPerSecond` number, double, nullable

## Other responses

- `401`: User is unauthorized.
- `404`: Application is not found.
- `500`: Unexpected server error.

## Changes

- **2026-11-12** `7bb58a0591b0`: 5 info
  - added the optional property `limits` to the response with the `200` status
  - added the optional property `regions/items/pods/items/cpuUsageCores` to the response with the `200` status
  - added the optional property `regions/items/pods/items/outboundBandwidthBytesPerSecond` to the response with the `200` status
  - added the optional property `regions/items/pods/items/ramUsageBytes` to the response with the `200` status
  - …1 more
- **2026-08-08** `0054dcaa32fb`: 3 info
  - added the optional property `regions/items/pods/items/containers/items/exitCode` to the response with the `200` status
  - added the optional property `regions/items/pods/items/outboundConnectionsLimit` to the response with the `200` status
  - added the optional property `regions/items/pods/items/outboundConnectionsRejectedDiff` to the response with the `200` status
- **2026-04-26** `62fb48c758fb`: 39 warning, 46 info
  - added the new `active` enum value to the `regions/items/status` response property for the response status `200`
  - added the new `active` enum value to the `status` response property for the response status `200`
  - added the new `couldBeBetter` enum value to the `activeInstances/statusGrade` response property for the response status `200`
  - added the new `couldBeBetter` enum value to the `activeRegions/statusGrade` response property for the response status `200`
  - …81 more

[Operation history](https://skmtc.dev/bunny/apis/magic-containers-api/changes/apps/:appId/overview/get.md)

---

[API](https://skmtc.dev/bunny/apis/magic-containers-api.md) - [All operations](https://skmtc.dev/bunny/apis/magic-containers-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bunny/apis/magic-containers-api/revisions/7bb58a0591b0?raw)