# List apps

> Source: https://elaichi.ai/docs/api-reference/apps/bundle/listbundles/

`GET /bundle`

Resource: **App** · API: **Apps**

## Query parameters

- **`q`** _(string)_
  Matches name and description. LIKE wildcards are matched literally. Max 200 characters.

## Response body

- **`result`** _(array<object>)_
  - **`id`** _(string)_
  - **`owner_user_id`** _(string)_
  - **`name`** _(string)_
  - **`description`** _(string)_
  - **`latest_version`** _(integer)_
  - **`item_count`** _(integer)_
  - **`access`** _(string)_
  - **`can_manage`** _(boolean)_
  - **`can_share`** _(boolean)_
  - **`can_transfer`** _(boolean)_
  - **`can_install`** _(boolean)_
  - **`can_share_external`** _(boolean)_
  - **`draft_revision`** _(integer)_
    Moves on every edit to the app and when a version is packaged; poll GET /bundle/{id}/draft/head.
  - **`inside`** _(object)_
    What the app holds: per-kind counts with at most three names each, and the connections its latest version asks for.
  - **`draft_changes`** _(object,null)_
    The working copy against the latest version, in words (at most 20 items plus a count of more). Null without edit access.
  - **`can_agent_edit`** _(boolean)_
    The in-app Agent can edit this app for the caller.
  - **`agent_edit_blocked_by`** _(string,null)_
    Why the Agent is unavailable to a caller who may edit.
- **`next_cursor`** _(string,null)_
- **`prev_cursor`** _(string,null)_

## Code examples

### curl

```bash
curl -X GET 'https://api.elaichi.ai/bundle' \
  -H 'Authorization: Bearer $ELAICHI_API_TOKEN' \
  -H 'Content-Type: application/json'
```

### JavaScript

```javascript
const response = await fetch('https://api.elaichi.ai/bundle', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer ' + process.env.ELAICHI_API_TOKEN,
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
```

### Python

```python
import os
import requests

url = "https://api.elaichi.ai/bundle"
headers = {
    "Authorization": f"Bearer {os.environ['ELAICHI_API_TOKEN']}",
    "Content-Type": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())
```