---
title: "Queries and returns matching mobile app files"
method: POST
path: "/mobile/apps/files/queryFiles"
tags: ["MobileAppFile"]
---

# Queries and returns matching mobile app files

`POST /mobile/apps/files/queryFiles`

Used to query mobile app files, POST operation to allow passing in query options in the body.

## Query parameters

- `workspace_id` string, required
- `limit` integer
- `cursor` string

## Request body

- MobileAppFileQueryOptions
  - `filter_conditions` MobileAppFileFilterCondition[] — Filters to get the relevant mobile app files
    - `comparator` 'contains' | 'equal' | 'greater_than' | 'greater_than_or_equal' | 'in' | 'less_than' | 'less_than_or_equal', required — Comparator operators used in filtering conditions
    - `numeric_value` integer — Numeric value for comparison
    - `string_value` string — String value for comparison
    - `string_values` string[] — Array of string values for comparison (only 'in' comparator makes sense when array is used)
    - `column_name` 'created_by_id' | 'created_time' | 'name' | 'platform' | 'version', required — Column name to apply the constraint to
  - `sort_columns` MobileAppFileSortColumn[] — Options to sort the relevant mobile app files by
    - `column_name` 'created_time' | 'name' | 'platform' | 'size' | 'version', required — Column name to sort by
    - `sort_direction` 'ASC' | 'DESC', required — Direction of sort when ordering query results

## Response `200`

Array of mobile app files matching the query

- MobileAppFileQueryResult — result envelope for mobile qpp query results
  - `mobile_app_files` MobileAppFile[] — All mobile app files that matched the query
    - `branch` string — The branch from which this mobile app file was built
    - `content_type` string — The content type of the mobile app file file
    - `crc32c_hex` string — The CRC32C checksum for this mobile app file, encoded as a hex string
    - `created_by_id` string — The ID of the user who created this mobile app file
    - `created_time` integer — The time at which this mobile app file was created
    - `download_url` string — Signed URL used to download this mobile app file
    - `extension` string — The file extension, defined as all characters of the name following (but not including) the last "." , e.g. "apk" or "app" The specific extension is important in the case of mobile because the emulators/simulators/devices validate that the app file is the expected type by inspecting the extension. Some platforms, like ios, use multiple extensions, so it is not always possible to infer the extension from the platform.
    - `id` string — The unique ID for this mobile app file
    - `labels` string[] — Labels associated with this mobile app file
    - `last_updated_by_id` string — The ID of the user who last updated this mobile app file
    - `last_updated_time` integer — The time at which this mobile app file was last updated
    - `name` string — The name of the mobile app file file, e.g. mabl-v1.2.3.apk
    - `platform` 'android' | 'ios' — The mobile platform associated with this object
    - `size` integer — The size of the mobile app file file in bytes
    - `uri` string — The URI of the mobile app file indicating its path in cloud storage
    - `version` string — The version of the mobile app file, e.g. 1.4.5 or a git hash
    - `workspace_id` string — The ID of the workspace that this mobile app file belongs to
  - `cursor` string — Cursor used for pagination

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)