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

# List Devices

## Overview

This endpoint retrieves a list of all WhatsApp Web devices associated with your account. It provides information about active and connected WhatsApp Web sessions, allowing you to monitor and manage device connections, and use instance\_id later for sending out Whatsapp messages to customers.

## Authentication

This endpoint requires API key authentication via the request header.

**Header:**

* `apikey`: Your API key for authentication (required)
* Autherizaion: Bearer token: The token been generated from the login API (required)

## Required Variables

* `{{baseUrl}}`: The base URL of the API server
* `{{apikey}}`: Your unique API key for authentication
* `{{token}}`: Your unique API key for authentication

## Expected Response

The endpoint returns a JSON response containing an array of WhatsApp Web device objects. Each device object typically includes:

* Device ID
* Device name/type
* Connection status
* Last active timestamp
* Session information

**Success Response (200 OK):**

```json theme={null}
{
  "success": true,
  "devices": [
    {
      "id": "device_id_123",
      "name": "Chrome on Windows",
      "status": "connected",
      "lastActive": "2024-01-15T10:30:00Z",
       "instance_id": "14wdfwef-da6f-11f0-3314-32423432"
    }
  ]
}
```

## Use Cases

* **Device Management**: Monitor all active WhatsApp Web sessions connected to your account
* **Session Monitoring**: Track device activity and connection status
* **Multi-device Support**: Manage multiple WhatsApp Web instances across different devices
* **Automated Monitoring**: Integrate with monitoring systems to track device health and connectivity


## OpenAPI

````yaml GET /api/whatsapp-web-devices
openapi: 3.1.0
info:
  title: Wassly API Documentation
  version: 1.0.0
  description: Wassly API Documentation.
servers:
  - url: https://www.wassly.com
security: []
paths:
  /api/whatsapp-web-devices:
    get:
      tags:
        - Whatsapp Web API
      operationId: Whatsapp_Web_API_List_Devices_get_api_whatsapp_web_devices
      responses:
        '200':
          description: OK
      security:
        - bearerAuth: []
          apiKeyAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````