# lan clients — NCM API

Beta. The client devices NetCloud Manager has observed on your routers' LANs. Read-only, and a single list call returns every known client, making this the endpoint to poll for what is actually connected right now. Pair it with router lans for the interface-side view of the same network.

Base URL: https://api.cradlepointecm.com

## Authentication

This is a v3 endpoint (`/api/v3/` path). Send a Bearer token on every request:

```http
Authorization: Bearer <token>
```

Tokens are generated in the NCM UI under API Keys. The v2 and v3 auth schemes are NOT interchangeable: v2 API-key headers are rejected on v3 endpoints.

### GET /api/v3/lan_clients

Get LAN clients

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[router] | query | string | no | Filter by router IDs (comma-separated) |
| filter[hostname] | query | string | no | Filter by hostnames (comma-separated) |
| filter[network_type] | query | string | no | Filter by network types (comma-separated) |

**Example request**

```bash
curl "https://api.cradlepointecm.com/api/v3/lan_clients" \
  -H "Authorization: Bearer <token>"
```

**Response 200** — Successful response

**Response 400** — Bad Request

**Response 403** — Forbidden