List All Devices

GET /api/devices/by-api-key

List all WhatsApp devices belonging to a tenant. Unlike every other endpoint, this one authenticates with your account-level tenant API key — not a Device Key — so an integration can enumerate a customer's devices and then call the per-device endpoints with each device's own key.

Auth: apikey header = your tenant API key (details)
Rate limit: 120/min per API key

Request

curl https://app.rapiwa.com/api/devices/by-api-key \
  -H "apikey: YOUR_TENANT_API_KEY"

Response

{
  "success": true,
  "devices": [
    {
      "id": "1024",
      "name": "Sales line",
      "phone_number": "8801234567890",
      "status": "connected",
      "device_key": "ab12••••ef90"
    }
  ]
}

Masked keys

device_key is masked (first 4 + last 4 characters). The full Device Key is shown only once in the dashboard when the device is created — store it securely then. This endpoint is for discovery, not key retrieval.

Fields

Field	Description
`id`	Device (session) id
`name`	Display name you gave the device
`phone_number`	Linked WhatsApp number (empty until first linked)
`status`	Connection status, e.g. `connected`, `disconnected`
`device_key`	Masked Device Key