Measure Memory API
Memory trends by app version, device-tier percentiles and high-memory sessions.
Memory trends by app version, device-tier percentiles and high-memory sessions.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/measure-sh:measure-sh-memory-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Measure Dashboard Memory API
version: 1.0.0
description: 'Reference for Measure''s Dashboard REST API. Every endpoint, request body,
response format and status code.
Requests are authenticated with the user''s access token in
`Authorization: Bearer ` format, unless cookies are used to
send tokens. Set `Content-Type: application/json; charset=utf-8` on each
request.
Failed requests have the following response shape:
```json
{
"error": "Error message",
"details": "Additional error details, when available"
}
```'
servers:
- url: https://api.measure.sh
description: Measure cloud
- url: http://localhost:8080
description: Self-hosted Measure API origin
security:
- bearerAuth: []
tags:
- name: Memory
description: Memory trends by app version, device-tier percentiles and high-memory sessions.
paths:
/apps/{id}/memory/plots/usage:
get:
operationId: getMemoryUsagePlot
tags:
- Memory
summary: Fetch memory usage by app version
description: 'Returns memory usage percentiles (p50, p90, p95 and p99) for each app version and time bucket.
- Values are in KB (1024 bytes). Android reports anonymous RSS plus swap, and iOS and iPadOS report used memory.
- Percentiles are calculated from individual samples.
- Buckets without samples are left out.
- Filter by app state with `app_state:eq:`. It applies to Android samples only. Without it, samples of every app state are included.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- $ref: '#/components/parameters/Timezone'
- $ref: '#/components/parameters/PlotTimeGroup'
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type:
- array
- 'null'
description: No matching samples may be returned as null or an empty array.
items:
$ref: '#/components/schemas/MemoryUsagePlotPoint'
example:
- version: 1.2.3 (42)
datetime: 2026-09-10
p50: 102400
p90: 204800
p95: 307200
p99: 409600
sample_count: 1200
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/memory/plots/breakdown:
get:
operationId: getMemoryUsageBreakdown
tags:
- Memory
summary: Fetch memory usage by device tier
description: 'Returns memory usage percentiles (p50, p90 and p95) for each device memory tier across the date range, with the number of sessions and samples in each tier.
- Values are in KB (1024 bytes). Android reports anonymous RSS plus swap, and iOS and iPadOS report used memory.
- Tiers are ordered from smallest to largest, followed by `unknown`. Tiers without samples are left out.
- Android tiers use the device''s RAM, and iOS and iPadOS tiers use the sample''s `max_memory`.
- Filter by app state with `app_state:eq:`. It applies to Android samples only. Without it, samples of every app state are included.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
type:
- array
- 'null'
description: No matching samples may be returned as null or an empty array.
items:
$ref: '#/components/schemas/MemoryUsageBreakdownRow'
example:
- device_total_memory_tier: 5-6gb
p50: 102400
p90: 204800
p95: 307200
session_count: 30
sample_count: 1200
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
/apps/{id}/memory/sessions/highUsage:
get:
operationId: getHighMemoryUsageSessions
tags:
- Memory
summary: Fetch sessions with high memory usage
description: 'Returns sessions with at least one sample close to the app''s memory limit, highest usage first.
- On Android, a sample qualifies when it reaches 75% of its memory target. The target depends on the device''s RAM and the sample''s app importance. `peak_memory_kb`, `target_memory_kb` and `percent_of_target` describe the sample with the highest percentage of its target. Sessions are ordered by `percent_of_target`.
- On iOS and iPadOS, a sample qualifies when it uses 75% or more of the memory available to the app, `used_memory / (used_memory + available_memory)`. Samples without available memory are ignored. Sessions are ordered by `peak_memory_limit_utilization`.
- Values are in KB (1024 bytes). Android reports anonymous RSS plus swap, and iOS and iPadOS report used memory.
- Filter by app state with `app_state:eq:`. It applies to Android samples only. Without it, samples of every app state are included.'
parameters:
- name: id
in: path
required: true
description: App's UUID.
schema:
type: string
format: uuid
- $ref: '#/components/parameters/From'
- $ref: '#/components/parameters/To'
- $ref: '#/components/parameters/FilterExpr'
- name: limit
in: query
description: Maximum sessions to return. The dashboard requests 5.
schema:
type: integer
default: 10
minimum: 1
maximum: 1000
- name: offset
in: query
description: Number of sessions to skip.
schema:
type: integer
default: 0
minimum: 0
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
$ref: '#/components/schemas/HighMemoryUsageSessionsResponse'
example:
results:
- session_id: 8d5a6d39-4c76-43d3-aecd-650e2c36f9c2
app_id: 2b7ddad4-40a6-42a7-9e21-a90577e08263
first_event_time: 2026-09-10 10:00:00+00:00
last_event_time: 2026-09-10 10:05:00+00:00
peak_memory_kb: 3145728
target_memory_kb: 2359296
percent_of_target: 133.33333333333334
attribute:
app_version: 1.2.3
app_build: '42'
device_name: Pixel
device_model: Pixel
device_manufacturer: Google
device_total_memory: 6291456
os_name: android
os_version: '15'
meta:
next: false
previous: false
'400':
description: Request URI is malformed or does not meet one or more acceptance criteria. Check the `error` field for more details.
'401':
description: Either the user's access token is invalid or has expired.
'403':
description: Requester does not have access to this resource.
'429':
description: Rate limit of the requester has crossed maximum limits.
'500':
description: Measure server encountered an unfortunate error. Report this to your server administrator.
components:
parameters:
Timezone:
name: timezone
in: query
required: true
description: 'IANA timezone used to bucket and format datetime values in the response. Example: `Asia/Kolkata`.'
schema:
type: string
FilterExpr:
name: filter_expr
in: query
required: false
description: 'Conditions joined by `AND` or `OR` and grouped with parentheses,
each reading `key:operator:values` with the names
`/apps/{id}/filters/keys` publishes. `AND` binds tighter than `OR`.
```
version_name:in:[1.2.0,1.1.9] AND mapping_type:not_in:jsbundle
(version_name:contains:SNAPSHOT AND mapping_type:in:proguard) OR patch_id:is_set
```
An operator taking no values ends its condition, as
`patch_id:is_set` does. Double-quote a value holding a space,
comma, bracket, colon or quote, with `\"` and `\\` inside.
At most 4096 bytes, 32 conditions, 4 levels of nesting and 200
values in one condition.
'
schema:
type: string
To:
name: to
in: query
required: false
description: 'ISO 8601 UTC string in milliseconds precision. Example: `2023-11-01T18:30:00.000Z`. Omitting both `from` and `to` returns the last seven days.'
schema:
type: string
PlotTimeGroup:
name: plot_time_group
in: query
required: false
description: Time bucket used for plot aggregation. Defaults to `days`.
schema:
type: string
enum:
- minutes
- hours
- days
- months
From:
name: from
in: query
required: false
description: 'ISO 8601 UTC string in milliseconds precision. Example: `2023-11-01T18:30:00.000Z`. Omitting both `from` and `to` returns the last seven days.'
schema:
type: string
schemas:
MemoryUsageKB:
type:
- number
- 'null'
description: Memory usage in KB (1024 bytes).
MemoryUsagePlotPoint:
type: object
required:
- version
- datetime
- p50
- p90
- p95
- p99
- sample_count
properties:
version:
type: string
description: App version and build formatted as "version (build)".
datetime:
type: string
description: Time bucket formatted in the requested timezone and plot_time_group.
p50:
$ref: '#/components/schemas/MemoryUsageKB'
p90:
$ref: '#/components/schemas/MemoryUsageKB'
p95:
$ref: '#/components/schemas/MemoryUsageKB'
p99:
$ref: '#/components/schemas/MemoryUsageKB'
sample_count:
type: integer
minimum: 0
description: Samples for this version/build and time bucket, across device tiers.
DeviceTotalMemoryTier:
type: string
description: Device RAM tier, from the device's RAM rounded up to a whole GB. Each tier includes both ends of its range. Zero or unreported RAM is unknown. GB uses 1024 * 1024 KB.
enum:
- 0-4gb
- 5-6gb
- 7-8gb
- 9-12gb
- 13-16gb
- 17-32gb
- 33gb+
- unknown
HighMemoryUsageSession:
type: object
required:
- session_id
- app_id
- attribute
- first_event_time
- last_event_time
- peak_memory_kb
properties:
session_id:
type: string
format: uuid
app_id:
type: string
format: uuid
first_event_time:
type: string
format: date-time
last_event_time:
type: string
format: date-time
peak_memory_kb:
type: integer
description: Session maximum memory usage across matching samples, in KB (1024 bytes).
target_memory_kb:
type: integer
description: Android-only configured target in KB for the device tier and app importance. Omitted on iOS/iPadOS.
percent_of_target:
type: number
description: Android-only 100 * peak memory / target. Omitted on iOS/iPadOS.
peak_memory_limit_utilization:
type: number
minimum: 0
maximum: 1
description: iOS/iPadOS-only maximum per-sample footprint / (footprint + available memory), as a ratio from 0 to 1. Omitted on Android.
available_memory_at_peak_utilization_kb:
type: integer
minimum: 0
description: iOS/iPadOS-only memory available to the app at the sample with peak utilization, in KB (1024 bytes). If multiple samples share the peak utilization, uses the latest timestamp. Zero means no memory available for additional allocation. This may differ from available memory at peak memory usage. Omitted on Android.
attribute:
type: object
additionalProperties: true
properties:
app_version:
type: string
app_build:
type: string
device_name:
type: string
device_model:
type: string
device_manufacturer:
type: string
os_name:
type: string
os_version:
type: string
device_total_memory:
type: integer
description: Device RAM in KB (1024 bytes).
MemoryUsageBreakdownRow:
type: object
required:
- device_total_memory_tier
- p50
- p90
- p95
- session_count
- sample_count
properties:
device_total_memory_tier:
$ref: '#/components/schemas/DeviceTotalMemoryTier'
p50:
$ref: '#/components/schemas/MemoryUsageKB'
p90:
$ref: '#/components/schemas/MemoryUsageKB'
p95:
$ref: '#/components/schemas/MemoryUsageKB'
session_count:
type: integer
minimum: 0
description: Distinct sessions contributing samples to this tier.
sample_count:
type: integer
minimum: 0
description: Samples contributing to this tier across the whole date range and matching versions.
HighMemoryUsageSessionsResponse:
type: object
required:
- results
- meta
properties:
results:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/HighMemoryUsageSession'
meta:
type: object
required:
- next
- previous
properties:
next:
type: boolean
previous:
type: boolean
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'User access token issued at sign-in. Sent as
`Authorization: Bearer <access-token>` unless cookies are used to send
tokens. The `/auth/refresh` and `/auth/signout` endpoints expect the
session''s refresh token in the same header format instead.
'