---
title: "List accessible apps"
method: GET
path: "/v1/apps"
tags: ["Apps"]
deprecated: true
---

# List accessible apps

`GET /v1/apps`

## Request

- Base URL: `https://api.chat.ethora.com`
- URL: `https://api.chat.ethora.com/v1/apps`
- Auth: HTTP bearer

> **Deprecated.**

**Deprecated**: use `/v2/apps` instead.

**Auth**: User JWT

Returns the applications visible to the current auth context.
With a user access token, the list is filtered by that user's readable ACL entries.
With `x-custom-token` server auth, the request runs under the token app context and uses the creator user's ACL for that app.
Parameters should be sent in the query string for GET requests.
Pagination uses `limit` and `offset`, where `offset` is the number of records to skip.

## Query parameters

- `limit` integer
- `offset` integer
- `orderBy` 'displayName' | 'totalRegistered' | 'totalSessions' | 'totalApiCalls' | 'totalFiles' | 'totalTransactions' | 'createdAt' | 'totalChats'
- `order` 'asc' | 'desc'

## Response `200`

```
{
  apps: [{
    _id: string,
    displayName: string,
    domainName: string,
    creatorId: string,
    bundleId: string,
    primaryColor: string,
    coinSymbol: string,
    coinName: boolean,
    defaultAccessProfileOpen: boolean,
    defaultAccessAssetsOpen: boolean,
    usersCanFree: boolean,
    isUserDataEncrypted: boolean,
    parentAppId: boolean,
    isAllowedNewAppCreate: boolean,
    isBaseApp: boolean,
    defaultRooms: [{jid: string, pinned: boolean}],
    createdAt: string,
    updatedAt: string,
    appToken: string,
    stats: {
      totalRegistered: number,
      recentlyRegistered: number,
      totalSessions: number,
      recentlySessions: number,
      totalApiCalls: number,
      recentlyApiCalls: number,
      totalFiles: number,
      recentlyFiles: number,
      totalTransactions: number,
      recentlyTransactions: number,
      totalIssuance: number,
      recentlyIssuance: number,
    }
  }],
  total: number,
  limit: number,
  offset: number
}
```

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal server error ``` {error: string} ```

---

[API](https://skmtc.dev/ethora/apis/platform-api.md) · [All operations](https://skmtc.dev/ethora/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ethora/apis/platform-api/revisions/01b6e64378ee?raw)