Measure Memory API

Memory trends by app version, device-tier percentiles and high-memory sessions.

GitHub OpenAPI

Operations 3

GET /apps/{id}/memory/plots/usage Fetch memory usage by app version #
GET /apps/{id}/memory/plots/breakdown Fetch memory usage by device tier #
GET /apps/{id}/memory/sessions/highUsage Fetch sessions with high memory usage #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/measure-sh:measure-sh-memory-api"
All apis
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.

Get an API 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 Specification

measure-sh-memory-api-openapi.yml Raw ↑
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.

        '