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

# Get analytics for the authenticated organization

`GET /v1/analytics`

## Query parameters

- `from` string, date-time, required
- `to` string, date-time, required
- `region` string
- `bucket` 'hour' | 'day' | 'week' | 'minute'
- `timezone` string
- `labels` string

## Response `200`

OK

- AnalyticsResponse
  - `from` string, date-time, required
  - `to` string, date-time, required
  - `bucket` 'hour' | 'day' | 'week' | 'minute', required
  - `timezone` string, required — IANA timezone used for time bucket grouping
  - `asOf` string, date-time, required
  - `series` AnalyticsEntry[], required
    - `timestamp` string, required — RFC3339 timestamp for the start of the bucket in the requested timezone, including the local offset
    - `android` object, required — Map of region to analytics stats for Android
    - `ios` object, required — Map of region to analytics stats for iOS
    - `xcode` object, required — Map of region to analytics stats for Xcode
    - `gradle` object, required — Map of region to analytics stats for Gradle
    - `instances` AnalyticsInstance[] — Individual instance details for this time bucket
      - `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
  - `summary` AnalyticsSummary, required — Summary of analytics across all time buckets, broken down by platform and region
    - `android` object, required — Map of region to analytics stats for Android
    - `ios` object, required — Map of region to analytics stats for iOS
    - `xcode` object, required — Map of region to analytics stats for Xcode
    - `gradle` object, required — Map of region to analytics stats for Gradle

## 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)