---
title: "Get per-instance analytics for the authenticated organization"
method: GET
path: "/v1/analytics/instances"
---

# Get per-instance analytics for the authenticated organization

`GET /v1/analytics/instances`

Returns per-instance analytics grouped by minute bucket for detailed chart views.

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `region` string
- `timezone` string
- `labels` string

## Response `200`

OK

- AnalyticsInstancesResponse
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `asOf` string, date-time, required
  - `timezone` string, required — IANA timezone used for time bucket grouping
  - `series` AnalyticsInstanceEntry[], required
    - `timestamp` string, required — RFC3339 timestamp for the start of the minute bucket in the requested timezone, including the local offset
    - `instances` AnalyticsInstance[], required
      - `instanceTid` string, required — Instance type ID (e.g., ios_xxx, android_xxx)
      - `platform` 'android' | 'ios' | 'xcode' | 'gradle', required — Platform name.
      - `region` string — Region where the instance ran
      - `runtimeMinutes` integer, required — Actual runtime minutes before platform multiplier
      - `billedMinutes` integer, required — Billed minutes with platform multiplier applied
      - `cost` number, double, required — Total cost in dollars for this instance
      - `labels` object — Instance labels at billing time
      - `billedBreakdown` BilledBreakdown
        - `creditsBilledMinutes` integer, required
        - `subscriptionBilledMinutes` object — Map of subscription ID to billed minutes
        - `planBilledMinutes` object — Map of plan ID to billed minutes
        - `onDemandBilledMinutes` integer, required
      - `costBreakdown` CostBreakdown — Cost breakdown by billing source in dollars
        - `creditsCost` number, double, required — Cost from credits (always 0)
        - `subscriptionCost` object — Map of subscription ID to cost in dollars
        - `planCost` object — Map of plan ID to cost in dollars
        - `onDemandCost` number, double, required — Cost from on-demand billing in dollars

## Other responses

- `default` — Error

---

[API](https://skmtc.net/limrun-inc/apis/limrun-api.md) · [All operations](https://skmtc.net/limrun-inc/apis/limrun-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limrun-inc/limrun-api/versions/0a3cd7959546/schema)