# Subuser geofences

## API actions

API path: `/subuser/zones`.

### bind

Gives access for sub-user to specified geofences.

**required tariff features:** `multilevel_access` – for ALL trackers.**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name            | description                                                                                                              | type      |
| --------------- | ------------------------------------------------------------------------------------------------------------------------ | --------- |
| subuser\_id     | ID of a sub-user belonging to current account.                                                                           | int       |
| access\_to\_all | Optional. If `true` then sub-user will have access to all geofences of master user.                                      | boolean   |
| zone\_ids       | Optional. List of geofence IDs to associate with a specified sub-user. All geofences must belong to current master user. | int array |

> At least one of `access_to_all` and `zone_ids` parameters must be not null.

#### Examples

cURL

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/subuser/zones/bind' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "subuser_id": 204951, "access_to_all": false, "zone_ids": [7548]}'
```

{% endcode %}

#### Response

```json
{
  "success": true
}
```

#### Errors

* 13 – Operation not permitted – if user has insufficient rights.
* 201 – Not found in the database – if sub-user/geofence does not exist or does not belong to current master user.
* 236 – Feature unavailable due to tariff restrictions (if there is at least one tracker without `multilevel_access` tariff feature).

### unbind

Disables access for sub-user to specified geofences.

**required tariff features:** `multilevel_access` – for ALL trackers.**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name        | description                                                                                                    | type      |
| ----------- | -------------------------------------------------------------------------------------------------------------- | --------- |
| subuser\_id | ID of a sub-user belonging to current account.                                                                 | int       |
| zone\_ids   | List of geofence IDs to associate with a specified sub-user. All geofences must belong to current master user. | int array |

#### Examples

cURL

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/subuser/zones/unbind' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "subuser_id": 204951, "zone_ids": [7548]}'
```

{% endcode %}

#### Response

```json
{
  "success": true
}
```

#### Errors

* 13 – Operation not permitted – if user has insufficient rights.
* 201 – Not found in the database – if sub-user/geofence not exist or does not belong to current master user.
* 236 – Feature unavailable due to tariff restrictions (if there is at least one tracker without `multilevel_access` tariff feature).

### list\_ids

Gets a list of geofence IDs to which this sub-user has access.

**required tariff features:** `multilevel_access` – for ALL trackers.**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name        | description                                    | type |
| ----------- | ---------------------------------------------- | ---- |
| subuser\_id | ID of a sub-user belonging to current account. | int  |

#### Examples

cURL

```sh
curl -X POST 'https://api.eu.navixy.com/v2/subuser/zones/list_ids' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "subuser_id": 204951}'
```

#### Response

```json
{
  "success": true,
  "access_to_all": true,
  "list": [7548]
}
```

#### Errors

* 13 – Operation not permitted – if user has insufficient rights.
* 201 – Not found in the database – if sub-user with such an ID does not exist or does not belong to current master user.
* 236 – Feature unavailable due to tariff restrictions (if there is at least one tracker without `multilevel_access` tariff feature).

### list

Gets a list of geofences to which this sub-user has access.

**required tariff features:** `multilevel_access` – for ALL trackers.**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name        | description                                                                                 | type                                                                              |
| ----------- | ------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
| subuser\_id | ID of a sub-user belonging to current account.                                              | int                                                                               |
| filter      | Optional. Filter for geofence label.                                                        | string                                                                            |
| tag\_ids    | Optional. Tag IDs assigned to geofences. Geofences found must include all tags from a list. | int array                                                                         |
| offset      | Optional. Offset from start of found geofences for pagination.                              | int                                                                               |
| limit       | Optional. Limit of found geofences for pagination.                                          | int                                                                               |
| order       | Optional. Specify list ordering. Can be any of `id`, `label`. Default order by `id`.        | [enum](https://www.navixy.com/docs/navixy-api/user-api/backend-api/..#data-types) |

#### Examples

cURL

{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/subuser/zones/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "22eac1c27af4be7b9d04da2ce1af111b", "subuser_id": 204951, "offset": 0, "limit": 1000}'
```

{% endcode %}

#### Response

```json
{
  "success": true,
  "access_to_all": false,
  "list": [<zone>, ...],
  "count": 12
}
```

#### Errors

* 13 – Operation not permitted – if user has insufficient rights.
* 201 – Not found in the database – if sub-user with such an ID does not exist or does not belong to current master user.
* 236 – Feature unavailable due to tariff restrictions (if there is at least one tracker without `multilevel_access` tariff feature).