### Query Parameters

| Name                  | Type    | Description                                                                                                               |
|-----------------------|---------|---------------------------------------------------------------------------------------------------------------------------|
| `excludeSharedDevices`| boolean | Default: `false`. Set `true` to limit the response to Spotters registered directly to your account.

### Response Description

The response body contains a list of Spotters associated with the account, ordered by `spotterId`.

| Name      | Type   | Description                                                                                                  |
|-----------|--------|--------------------------------------------------------------------------------------------------------------|
| `spotterId` | string | The Spotter's identifier.                                                                                     |
| `name`      | string | The Spotter's display name, as configured in the [Spotter Dashboard](https://spotter.sofarocean.com/). Returns `null` if no display name has been set. |
| `hullType`  | string | The Spotter's hull type. Can be `spotter`, `scout` or `velella`.

### Examples

#### Example Request

```bash
curl "https://api.sofarocean.com/api/devices" -H 'token: YOUR_API_TOKEN'
```

#### Example Responses

**2 Devices:**

```json
{
  "message": "2 devices",
  "data": {
    "devices": [
      {
        "spotterId": "SPOT-0017",
        "hullType": "spotter",
        "name": "Mavericks 1"
      },
      {
        "spotterId": "SPOT-0018",
        "hullType": "spotter",
        "name": "Golden Gate"
      }
    ]
  }
}
```

**No Devices:**

```json
{
    "message": "0 devices",
    "data": {
        "devices": []
    }
}
```

**Incorrect Token:**

```json
{
    "message": "Authentication Failed"
}
```

**Missing Token:**

```json
{
    "message": "No token provided"
}
```