Measure Profiles API
Profiles captured on Android by trigger-based profiling.
Profiles captured on Android by trigger-based profiling.
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-profiles-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 Profiles 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: Profiles
description: Profiles captured on Android by trigger-based profiling.
paths:
/apps/{id}/profiles:
get:
operationId: getProfiles
tags:
- Profiles
summary: Fetch profiles
description: 'Returns the app''s profiles, newest first. A profile is captured on Android 16 and above when a profiling trigger fires, such as an ANR or the app being fully drawn.
- Each attachment''s `location` is a signed URL for the profile''s trace or heap dump. The file uploads separately from the event, so it can be missing for a short while after the profile appears.
- Filter by trigger with `profile_trigger:in:`.'
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 profiles to return. The dashboard requests 10.
schema:
type: integer
default: 10
minimum: 1
maximum: 1000
- name: offset
in: query
description: Number of profiles to skip.
schema:
type: integer
default: 0
minimum: 0
responses:
'200':
description: Successful response, no errors.
content:
application/json:
schema:
$ref: '#/components/schemas/ProfilesResponse'
example:
results:
- id: 5f1c3b0e-8a7d-4f1e-9c2b-6d4e8a1f3c70
app_id: 2b7ddad4-40a6-42a7-9e21-a90577e08263
session_id: 8d5a6d39-4c76-43d3-aecd-650e2c36f9c2
timestamp: 2026-09-30 16:22:39+00:00
trigger: anr
format: perfetto_trace
attribute:
app_version: 1.2.3
app_build: '42'
os_name: android
os_version: '36'
device_manufacturer: Google
device_model: Pixel 9
attachments:
- id: 66b50d91-f120-4f2f-941c-6a7c33129ef0
name: profile_trigger-type-2_2026-09-30-21-52-39-964_uid-10243.perfetto-trace
type: perfetto_trace
key: 66b50d91-f120-4f2f-941c-6a7c33129ef0.perfetto-trace
location: http://localhost:9111/msr-attachments-sandbox/66b50d91-f120-4f2f-941c-6a7c33129ef0.perfetto-trace
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:
Profile:
type: object
required:
- id
- app_id
- session_id
- timestamp
- trigger
- format
- attribute
- attachments
properties:
id:
type: string
format: uuid
app_id:
type: string
format: uuid
session_id:
type: string
format: uuid
timestamp:
type: string
format: date-time
description: When the profile was captured. An ANR profile carries the time of its ANR.
trigger:
type: string
description: The Android profiling trigger that captured the profile, such as `anr`, `app_fully_drawn`, `oom` or `cold_start`.
format:
type: string
description: Format of the profile artifact, such as `perfetto_trace`, `perfetto_java_heap_dump`, `perfetto_heap_profile` or `perfetto_stack_sample`.
attribute:
type: object
properties:
app_version:
type: string
app_build:
type: string
os_name:
type: string
os_version:
type: string
device_manufacturer:
type: string
device_model:
type: string
attachments:
type: array
items:
type: object
properties:
id:
type: string
name:
type: string
type:
type: string
key:
type: string
location:
type: string
description: Signed URL to the profile artifact.
ProfilesResponse:
type: object
required:
- results
- meta
properties:
results:
type:
- array
- 'null'
items:
$ref: '#/components/schemas/Profile'
meta:
type: object
required:
- next
- previous
properties:
next:
type: boolean
previous:
type: boolean
parameters:
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
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
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.
'