> ## Documentation Index
> Fetch the complete documentation index at: https://gowa-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get list connected devices

> Returns all device IDs known to the server, including placeholders created via the device API. Devices are now persisted in the storage registry so IDs remain stable after application restarts.




## OpenAPI

````yaml /openapi.yml get /app/devices
openapi: 3.0.0
info:
  title: WhatsApp API MultiDevice
  version: 9.7.0
  description: |
    This API is used for sending whatsapp via API.

    The web dashboard is a separate project (gowa-ui); the server downloads its
    latest release asset and serves it at `/` (or returns a JSON banner when
    APP_UI_ENABLED=false).

    Device scoping:
    - Send `X-Device-Id` on all device-scoped REST calls.
    - WebSocket: connect to `/ws?device_id=<id>`.
    - WebSocket auth (when basic auth is enabled): browsers cannot set an
      Authorization header on WebSocket connections, so also pass
      `&authorization=<base64(user:pass)>` in the query string. Use TLS in
      production since the credential is visible in the URL.
servers:
  - url: http://localhost:3000
security:
  - basicAuth: []
tags:
  - name: app
    description: Initial Connection to Whatsapp server
  - name: device
    description: Device management for multi-device support
  - name: user
    description: Getting information
  - name: send
    description: Send Message (Text/Image/File/Video).
  - name: message
    description: Message manipulation (revoke/react/update).
  - name: call
    description: Call management (reject incoming calls)
  - name: chat
    description: Chat conversations and messaging
  - name: group
    description: Group setting
  - name: newsletter
    description: newsletter setting
  - name: chatwoot
    description: Chatwoot integration for customer support
paths:
  /app/devices:
    get:
      tags:
        - app
      summary: Get list connected devices
      description: >
        Returns all device IDs known to the server, including placeholders
        created via the device API. Devices are now persisted in the storage
        registry so IDs remain stable after application restarts.
      operationId: appDevices
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInternalServer'
components:
  schemas:
    DeviceResponse:
      type: object
      properties:
        code:
          type: string
          example: SUCCESS
        message:
          type: string
          example: Fetch device success
        results:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
                example: Aldino Kemal
              device:
                type: string
                description: >-
                  Session ID registered via POST /devices (stable across
                  restarts)
                example: org_2
              jid:
                type: string
                description: WhatsApp JID of the logged-in account (empty until login)
                example: 628960561XXX@s.whatsapp.net
    ErrorInternalServer:
      type: object
      properties:
        code:
          type: string
          example: INTERNAL_SERVER_ERROR
          description: SYSTEM_CODE_ERROR
        message:
          type: string
          example: you are not loggin
          description: Detail error message
        results:
          type: object
          example: null
          description: additional data
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````

## Related topics

- [List all devices](https://gowa-docs.mintlify.site/api-reference/device/list-all-devices.md)
- [Get list of chats](https://gowa-docs.mintlify.site/api-reference/chat/get-list-of-chats.md)
- [Get list of user contacts](https://gowa-docs.mintlify.site/api-reference/user/get-list-of-user-contacts.md)
- [Get list of participants in a group](https://gowa-docs.mintlify.site/api-reference/group/get-list-of-participants-in-a-group.md)
- [Get device info](https://gowa-docs.mintlify.site/api-reference/device/get-device-info.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.