---
title: "List organization's all assets with given filters. If none given, return all assets."
method: GET
path: "/v1/assets"
---

# List organization's all assets with given filters. If none given, return all assets.

`GET /v1/assets`

## Query parameters

- `nameFilter` string
- `namePrefixFilter` string
- `includeAppStore` boolean
- `includeDownloadUrl` boolean
- `includeUploadUrl` boolean
- `kindFilter` 'App' | 'Keychain'
- `limit` integer

## Response `200`

OK

- Asset[]
  - `id` string, required
  - `name` string, required
  - `kind` 'App' | 'Keychain', required
  - `displayName` string — Human-readable display name for the asset. If not set, the name should be used.
  - `platform` 'ios' | 'android' | 'xcode'
  - `os` 'ios' | 'android' | 'xcode' — Deprecated: alias of platform, always mirrors it. Use platform instead.
  - `md5` string — Returned only if there is a corresponding file uploaded already.
  - `expiresAt` string, date-time — When set, the time after which the asset is automatically deleted.
  - `signedUploadUrl` string
  - `signedDownloadUrl` string

## Other responses

- `default` — Error

## Changes

> 34 revisions in range; 1 could not be searched.

- **2026-07-07** `22f89da81c8f` — 1 warning, 4 info
  - added the new `xcode` enum value to the `items/os` response property for the response status `200`
  - added the new optional `query` request parameter `kindFilter`
  - added the optional property `items/platform` to the response with the `200` status
  - response property `items/os` deprecated
  - …1 more
- **2026-06-18** `22b815649ef7` — 1 info
  - added the optional property `items/expiresAt` to the response with the `200` status
- **2026-04-24** `ed75334ca76b` — 1 info
  - added the new optional `query` request parameter `namePrefixFilter`
- **2026-01-21** `0bac46c041e3` — 1 info
  - added the new optional `query` request parameter `includeAppStore`
- **2026-01-07** `a1174a39309c` — 2 info
  - added the optional property `items/displayName` to the response with the `200` status
  - added the optional property `items/os` to the response with the `200` status

[Full history](https://skmtc.dev/limrun-inc/apis/limrun-api/changes/v1/assets/get.md)

---

[API](https://skmtc.dev/limrun-inc/apis/limrun-api.md) · [All operations](https://skmtc.dev/limrun-inc/apis/limrun-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/limrun-inc/limrun-api/revisions/0a3cd7959546/schema)