## List

`$ beeper-desktop-cli accounts list`

**get** `/v1/accounts`

Lists chat accounts across networks (WhatsApp, Telegram, Twitter/X, etc.) actively connected to this Beeper Desktop instance

### Returns

- `GetAccountsOutput: array of Account`

  Connected accounts the user can act through. Includes accountID and user identity.

  - `accountID: string`

    Chat account added to Beeper. Use this to route account-scoped actions.

  - `user: object { id, cannotMessage, email, 5 more }`

    User the account belongs to.

    - `id: string`

      Stable Beeper user ID. Use as the primary key when referencing a person.

    - `cannotMessage: optional boolean`

      True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

    - `email: optional string`

      Email address if known. Not guaranteed verified.

    - `fullName: optional string`

      Display name as shown in clients (e.g., 'Alice Example'). May include emojis.

    - `imgURL: optional string`

      Avatar image URL if available. May be temporary or local-only to this device; download promptly if durable access is needed.

    - `isSelf: optional boolean`

      True if this user represents the authenticated account's own identity.

    - `phoneNumber: optional string`

      User's phone number in E.164 format (e.g., '+14155552671'). Omit if unknown.

    - `username: optional string`

      Human-readable handle if available (e.g., '@alice'). May be network-specific and not globally unique.

### Example

```cli
beeper-desktop-cli accounts list
```