# List devices

> `GET https://api.kustom.co/ipp/v1/devices`

Lists all registered devices for the merchant, optionally filtered by location.

## Parameters

- `location_id` (string, query) — Filter by location ID.
- `metadata` (array<string>, query) — Filter by metadata key-value pair. Format: `key:value`. Repeat the parameter to apply multiple filters — all must match (AND semantics). Maximum 5 entries. Duplicate keys are not allowed.
- `page_number` (integer, query) — Zero-based page number. Defaults to 0.
- `page_size` (integer, query) — Page size. Defaults to 20.

## Responses

### 200

List of devices.

`application/json`

- `content[]` (array<any>)
- `total_elements` (integer)
- `total_pages` (integer)
- `page_number` (integer)
- `page_size` (integer)
- `first` (boolean)
- `last` (boolean)

```json
{
  "content": [
    "<string>"
  ],
  "total_elements": 0,
  "total_pages": 0,
  "page_number": 0,
  "page_size": 0,
  "first": false,
  "last": false
}
```

### 401

Missing or invalid credentials.

`application/json`