Measure Devices API

Sessions, errors, launch time, span duration and memory usage by device model.

GitHub OpenAPI

Operations 6

GET /apps/{id}/devices/plots/sessions Plot sessions by device over time #
GET /apps/{id}/devices/sessions List device models by session count #
GET /apps/{id}/devices/errors List device models by error count #
GET /apps/{id}/devices/launches List device models by launch duration #
GET /apps/{id}/devices/spans List device models by span duration #
GET /apps/{id}/devices/memory List device models by 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-devices-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-devices-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Measure Dashboard Devices 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: Devices
  description: Sessions, errors, launch time, span duration and memory usage by device model.
paths:
  /apps/{id}/devices/plots/sessions:
    get:
      operationId: getDevicesSessionsPlot
      tags:
      - Devices
      summary: Plot sessions by device over time
      description: 'Returns session counts by time bucket for the five device models with the most sessions in the date range.


        - A device is identified by its manufacturer and model. Sessions without a device model are excluded.

        - Each session is counted once, in the bucket where it started. Sessions that started before `from` are counted in the first bucket. As a result, each device’s plotted counts add up to its `session_count` in `/apps/{id}/devices/sessions`.

        - Buckets with no sessions are omitted.'
      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
                items:
                  $ref: '#/components/schemas/DeviceSessionsPlotPoint'
              example:
              - device_manufacturer: Google
                device_model: Pixel 8
                datetime: 2026-09-10
                session_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}/devices/sessions:
    get:
      operationId: getDevicesSessions
      tags:
      - Devices
      summary: List device models by session count
      description: 'Returns a page of device models, ranked by their session counts in the date range.


        - A session is counted if it overlaps the date range. Sessions without a device model are excluded.

        - `percent_of_sessions` is each device’s share of all matching sessions, including sessions on devices outside the current page.'
      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/DevicesOrder'
      - $ref: '#/components/parameters/DevicesLimit'
      - $ref: '#/components/parameters/DevicesOffset'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                required:
                - results
                - meta
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeviceSessionsRow'
                  meta:
                    $ref: '#/components/schemas/DevicesPageMeta'
              example:
                results:
                - device_manufacturer: Google
                  device_model: Pixel 8
                  device_name: shiba
                  session_count: 1200
                  percent_of_sessions: 42.5
                meta:
                  next: true
                  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.
  /apps/{id}/devices/errors:
    get:
      operationId: getDevicesErrors
      tags:
      - Devices
      summary: List device models by error count
      description: 'Returns a page of device models, ranked by their error counts in the date range.


        - Errors include crashes, ANRs, app hangs, and handled or unhandled exceptions.

        - `session_count` is the number of sessions with at least one error.'
      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/DevicesOrder'
      - $ref: '#/components/parameters/DevicesLimit'
      - $ref: '#/components/parameters/DevicesOffset'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                required:
                - results
                - meta
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeviceErrorsRow'
                  meta:
                    $ref: '#/components/schemas/DevicesPageMeta'
              example:
                results:
                - device_manufacturer: Google
                  device_model: Pixel 8
                  device_name: shiba
                  crash_count: 4
                  anr_count: 2
                  app_hang_count: 0
                  non_fatal_count: 12
                  error_count: 18
                  session_count: 9
                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.
  /apps/{id}/devices/launches:
    get:
      operationId: getDevicesLaunches
      tags:
      - Devices
      summary: List device models by launch duration
      description: 'Returns a page of device models, ranked by a duration percentile for the selected launch type.


        - Durations are in milliseconds. Launches without a duration are excluded.'
      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: launch_type
        in: query
        required: false
        description: App launch type to include.
        schema:
          type: string
          default: cold_launch
          enum:
          - cold_launch
          - warm_launch
          - hot_launch
      - $ref: '#/components/parameters/DevicesPercentile'
      - $ref: '#/components/parameters/DevicesOrder'
      - $ref: '#/components/parameters/DevicesLimit'
      - $ref: '#/components/parameters/DevicesOffset'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                required:
                - results
                - meta
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeviceDurationRow'
                  meta:
                    $ref: '#/components/schemas/DevicesPageMeta'
              example:
                results:
                - device_manufacturer: Samsung
                  device_model: SM-A546E
                  device_name: a54x
                  p50: 820
                  p90: 1450
                  p95: 1800
                  count: 340
                meta:
                  next: true
                  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.
  /apps/{id}/devices/spans:
    get:
      operationId: getDevicesSpans
      tags:
      - Devices
      summary: List device models by span duration
      description: 'Returns a page of device models, ranked by a duration percentile for the selected span.


        - Durations are in milliseconds.

        - Spans recorded before device models were added to span metrics have no device model and are excluded.'
      parameters:
      - name: id
        in: path
        required: true
        description: App's UUID.
        schema:
          type: string
          format: uuid
      - name: span_name
        in: query
        required: true
        description: Name of the span to include.
        schema:
          type: string
      - $ref: '#/components/parameters/From'
      - $ref: '#/components/parameters/To'
      - $ref: '#/components/parameters/FilterExpr'
      - $ref: '#/components/parameters/DevicesPercentile'
      - $ref: '#/components/parameters/DevicesOrder'
      - $ref: '#/components/parameters/DevicesLimit'
      - $ref: '#/components/parameters/DevicesOffset'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                required:
                - results
                - meta
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeviceDurationRow'
                  meta:
                    $ref: '#/components/schemas/DevicesPageMeta'
              example:
                results:
                - device_manufacturer: Apple
                  device_model: iPhone15,2
                  device_name: iPhone
                  p50: 310
                  p90: 620
                  p95: 790
                  count: 1500
                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.
  /apps/{id}/devices/memory:
    get:
      operationId: getDevicesMemory
      tags:
      - Devices
      summary: List device models by memory usage
      description: 'Returns a page of device models, ranked by a memory usage percentile.


        - Values are in KB (1024 bytes). Android reports anonymous RSS plus swap; iOS and iPadOS report used memory.

        - Percentiles are calculated from individual samples across all app states.'
      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/DevicesPercentile'
      - $ref: '#/components/parameters/DevicesOrder'
      - $ref: '#/components/parameters/DevicesLimit'
      - $ref: '#/components/parameters/DevicesOffset'
      responses:
        '200':
          description: Successful response, no errors.
          content:
            application/json:
              schema:
                type: object
                required:
                - results
                - meta
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/DeviceMemoryRow'
                  meta:
                    $ref: '#/components/schemas/DevicesPageMeta'
              example:
                results:
                - device_manufacturer: Google
                  device_model: Pixel 8
                  device_name: shiba
                  p50: 102400
                  p90: 204800
                  p95: 307200
                  session_count: 30
                  sample_count: 1200
                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:
  schemas:
    DeviceSessionsRow:
      type: object
      required:
      - device_manufacturer
      - device_model
      - device_name
      - session_count
      - percent_of_sessions
      properties:
        device_manufacturer:
          type: string
          description: Device manufacturer.
        device_model:
          type: string
          description: Device model, such as Pixel 8 or iPhone15,2.
        device_name:
          type: string
          description: The device name reported by most events for this model. A model may report more than one name.
        session_count:
          type: integer
          minimum: 0
          description: Sessions on the device that overlap the date range.
        percent_of_sessions:
          type: number
          minimum: 0
          maximum: 100
          description: The device's share of all matching sessions, as a percentage.
    MemoryUsageKB:
      type:
      - number
      - 'null'
      description: Memory usage in KB (1024 bytes).
    DeviceMemoryRow:
      type: object
      required:
      - device_manufacturer
      - device_model
      - device_name
      - p50
      - p90
      - p95
      - session_count
      - sample_count
      properties:
        device_manufacturer:
          type: string
          description: Device manufacturer.
        device_model:
          type: string
          description: Device model, such as Pixel 8 or iPhone15,2.
        device_name:
          type: string
          description: The device name reported by most events for this model. A model may report more than one name.
        p50:
          $ref: '#/components/schemas/MemoryUsageKB'
        p90:
          $ref: '#/components/schemas/MemoryUsageKB'
        p95:
          $ref: '#/components/schemas/MemoryUsageKB'
        session_count:
          type: integer
          minimum: 0
          description: Sessions with memory samples on the device.
        sample_count:
          type: integer
          minimum: 0
          description: Memory samples on the device.
    DeviceDurationRow:
      type: object
      required:
      - device_manufacturer
      - device_model
      - device_name
      - p50
      - p90
      - p95
      - count
      properties:
        device_manufacturer:
          type: string
          description: Device manufacturer.
        device_model:
          type: string
          description: Device model, such as Pixel 8 or iPhone15,2.
        device_name:
          type: string
          description: The device name reported by most events for this model. A model may report more than one name.
        p50:
          type:
          - number
          - 'null'
          description: Duration in milliseconds.
        p90:
          type:
          - number
          - 'null'
          description: Duration in milliseconds.
        p95:
          type:
          - number
          - 'null'
          description: Duration in milliseconds.
        count:
          type: integer
          minimum: 0
          description: Launches or spans on the device.
    DevicesPageMeta:
      type: object
      required:
      - next
      - previous
      properties:
        next:
          type: boolean
          description: True if more devices follow this page.
        previous:
          type: boolean
          description: True if devices precede this page.
    DeviceSessionsPlotPoint:
      type: object
      required:
      - device_manufacturer
      - device_model
      - datetime
      - session_count
      properties:
        device_manufacturer:
          type: string
          description: Device manufacturer.
        device_model:
          type: string
          description: Device model, such as Pixel 8 or iPhone15,2.
        datetime:
          type: string
          description: Start of the time bucket, formatted for the plot time group and requested timezone.
        session_count:
          type: integer
          minimum: 0
          description: Sessions on the device that started in this bucket.
    DeviceErrorsRow:
      type: object
      required:
      - device_manufacturer
      - device_model
      - device_name
      - crash_count
      - anr_count
      - app_hang_count
      - non_fatal_count
      - error_count
      - session_count
      properties:
        device_manufacturer:
          type: string
          description: Device manufacturer.
        device_model:
          type: string
          description: Device model, such as Pixel 8 or iPhone15,2.
        device_name:
          type: string
          description: The device name reported by most events for this model. A model may report more than one name.
        crash_count:
          type: integer
          minimum: 0
        anr_count:
          type: integer
          minimum: 0
          description: ANRs. Only Android reports these.
        app_hang_count:
          type: integer
          minimum: 0
          description: App hangs. Only iOS and iPadOS report these.
        non_fatal_count:
          type: integer
          minimum: 0
          description: Handled and unhandled exceptions.
        error_count:
          type: integer
          minimum: 0
          description: Total errors on the device.
        session_count:
          type: integer
          minimum: 0
          description: Sessions with at least one error.
  parameters:
    DevicesLimit:
      name: limit
      in: query
      required: false
      description: Maximum number of devices to return. The dashboard requests 5.
      schema:
        type: integer
        default: 10
        minimum: 1
        maximum: 1000
    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
    DevicesPercentile:
      name: percentile
      in: query
      required: false
      description: Percentile used to rank devices. The response includes all three percentiles.
      schema:
        type: string
        default: p95
        enum:
        - p50
        - p90
        - p95
    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
    DevicesOrder:
      name: order
      in: query
      required: false
      description: '`desc` puts the highest value first; `asc` puts the lowest value first. Ties are ordered by manufacturer, then model.'
      schema:
        type: string
        default: desc
        enum:
        - desc
        - asc
    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
    DevicesOffset:
      name: offset
      in: query
      required: false
      description: Number of devices to skip.
      schema:
        type: integer
        default: 0
        minimum: 0
  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.

        '