GET

List Devices

Retrieves all WhatsApp device slots configured for your organization, including their live connection states, trust scores, and warmup limits.

HTTP Endpoint

GEThttps://api-wa.hidessh.com/api/v1/wa/devices

Authentication

This endpoint requires Bearer authentication via your secret API Key.

Header Key	Value	Required
Authorization	Bearer <your_api_key>	Required
Content-Type	application/json	Required

Request Parameters

The request body must be formatted as JSON with the following parameters:

Parameter	Type	Required	Description
`page`	integer	Optional	Page number for pagination. default: 1example: 1
`size`	integer	Optional	Number of devices per page (max: 50). default: 10example: 10

Code Examples

request.sh

curl -X GET "https://api-wa.hidessh.com/api/v1/wa/devices?page=1&size=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Formats

Array of device objects with pagination metadata.

application/json • 200 OK

{
  "success": true,
  "message": "devices retrieved successfully",
  "payload": [
    {
      "id": "01M1WW3FKR1JS7CW4KGY78Q5ND",
      "tenant_id": "01M1TG7TWDHZSXVPBEAZVFNF24",
      "jid": "628123456789@s.whatsapp.net",
      "push_name": "Customer Support 1",
      "status": "CONNECTED",
      "trust_score": 85,
      "warmup_day": 14,
      "daily_sent_count": 42,
      "last_seen_at": "2026-09-07T09:45:35.481+07:00",
      "created_at": "2026-08-24T10:00:00.000+07:00"
    }
  ],
  "additional_info": {
    "page": 1,
    "size": 10,
    "total": 1
  }
}

Response Attributes Breakdown

Attribute	Type	Description
`payload[].status`	string	Connection status: 'QR_PENDING', 'CONNECTED', or 'DISCONNECTED'.
`payload[].trust_score`	integer	Dynamic health score (0-100) calculated from account age, spam flags, and response rates.
`payload[].warmup_day`	integer	Current day in anti-ban warmup schedule (Day 1: 50 msgs/day -> Day 14+: Unrestricted).

On this page