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

# List Apps

`GET /v1/apps`

## Request

- Base URL: `https://api.arcade.dev`
- URL: `https://api.arcade.dev/v1/apps`
- Auth: API key in header `Authorization`

Lists the apps the user can act on through this project, ordered by app_id, with whether each is connected and, when it is, the account it is connected as and the permissions that connection grants. An app is connected when the user can call its tools now: every connection it needs is in place, or it needs none. Returns the same apps the Arcade.ListApps tool reports.

## Query parameters

- `user_id` string, required
- `limit` integer
- `offset` integer

## Response `200`

OK

- SchemasOffsetPageSchemasAppResponse
  - `items` SchemasAppResponse[]
    - `account` string: Account is the account the user is connected as, as the app's provider reports it (an email address or username). Only set when connected.
    - `app_id` string: AppID identifies the app. Unique within a listing, which is sorted by it.
    - `connected` boolean: Connected is true when the user can call the app's tools now: every connection the app needs is in place, or it needs none.
    - `name` string: Name is the app's display name.
    - `permissions` string[]: Permissions are the scopes the user's connection grants. Only set when connected.
  - `limit` integer
  - `offset` integer
  - `total_count` integer

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-10-16** `4c694686f453`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/arcadeai/apis/arcade-api/changes/v1/apps/get.md)

---

[API](https://skmtc.dev/arcadeai/apis/arcade-api.md) - [All operations](https://skmtc.dev/arcadeai/apis/arcade-api/llms.txt) - [OpenAPI document](https://skmtc.dev/arcadeai/apis/arcade-api/revisions/f487ce74dc56?raw)