# 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

### GET /api/v3/beta/lan_clients

List lan clients

Returns a list of lan clients

> **Beta:** This endpoint is served on a `/beta/` path. Beta endpoints are still evolving and may change without the stability guarantees of GA endpoints.

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| filter[hostname] | query | string | no |  |
| filter[network_type] | query | string | no |  |
| filter[router] | query | string | no |  |
| page[after] | query | string | no | Cursor for next page. |
| page[before] | query | string | no | Cursor for prior page. |
| page[size] | query | integer | no | Number of results to return per page. |
| search | query | string | no | The search query param performs a case insensitive substring search on a set of fields. <br> A record matches if any search field matches the search text. <br>If the search param doesn't include a field list, the server selects the fields. <br>Example:<ul><li>Search by substring: `search=substring1,substring2` </li><li>Search by field(s) and substring: `search[fieldA,fieldB]=substring1,substring2,substring3` </li><ul> |

**Example request**

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

**Response 200**