Fetch a span's list of instances

GET/apps/{id}/spans

Fetch a span's list of instances, optionally narrowed by a filter expression.

Pass limit and offset values to paginate results.

Authorization

bearerAuth

AuthorizationBearer <token>

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.

In: header

Path Parameters

id*string

App's UUID.

Formatuuid

Query Parameters

span_name*string

Name of the span for which instances list is being fetched.

from?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

to?string

ISO 8601 UTC string in milliseconds precision. Example: 2023-11-01T18:30:00.000Z. Omitting both from and to returns the last seven days.

filter_expr?string

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.

offset?integer

Number of items to skip when paginating. Use with limit parameter to control amount of items fetched.

limit?integer

Number of items to return. Used for pagination. Should be used along with offset.

Response Body

`application/json`

curl -X GET "https://example.com/apps/497f6eca-6276-4993-bfeb-53cbbbba6f08/spans?span_name=string"

{  "meta": {    "next": false,    "previous": false  },  "results": [    {      "app_id": "e963e98a-aca9-4bab-bd62-70a74801384e",      "span_name": "activity.onCreate",      "span_id": "54b40eb484ade006",      "trace_id": "e0826847053bb9e539c9dc4d4da793ad",      "status": 0,      "start_time": "2024-11-18T14:14:55.491Z",      "end_time": "2024-11-18T14:14:55.573Z",      "duration": 82,      "app_version": "0.9.0-SNAPSHOT.debug",      "app_build": "900",      "os_name": "android",      "os_version": "35",      "device_model": "sdk_gphone16k_arm64",      "device_manufacturer": "Google"    },    {      "app_id": "e963e98a-aca9-4bab-bd62-70a74801384e",      "span_name": "activity.onCreate",      "span_id": "9f1890db9aedb305",      "trace_id": "d71f3d909689859469a7d9b38e605d56",      "status": 0,      "start_time": "2024-11-18T14:14:40.545Z",      "end_time": "2024-11-18T14:14:40.62Z",      "duration": 75,      "app_version": "0.9.0-SNAPSHOT.debug",      "app_build": "900",      "os_name": "android",      "os_version": "35",      "device_model": "sdk_gphone16k_arm64",      "device_manufacturer": "Google"    }  ]}