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: 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.
'