# Retranslator

Contains tracker retranslator binding object and API calls to bind/unbind it to tracker or get already binded one.

## Tracker retranslator binding object

```json
{
  "retranslator_id": 4548,
  "fake_device_id": "AI568T"
}
```

* `retranslator_id` - int. An ID of the retranslator.
* `fake_device_id` - string. Optional. If this field is set retranslator use it instead of real device ID to forward data.

## API actions

API base path: `/tracker/retranslator`.

### bind

Creates or updates binding.

**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name             | description                                                                                      | type   | format   |
| ---------------- | ------------------------------------------------------------------------------------------------ | ------ | -------- |
| tracker\_id      | ID of the tracker (aka "object\_id"). Tracker must belong to authorized user and not be blocked. | int    | 999199   |
| retranslator\_id | Retranslator ID.                                                                                 | int    | 123      |
| fake\_device\_id | Optional. If set the retranslator will use this value instead of real device ID to forward data. | string | "AI568T" |

#### Examples

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/tracker/retranslator/bind' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489, "retranslator_id": 123}'
```

{% endcode %}
{% endtab %}

{% tab title="HTTP GET" %}
{% code overflow="wrap" %}

```http
https://api.eu.navixy.com/v2/tracker/retranslator/bind?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489&retranslator_id=123
```

{% endcode %}
{% endtab %}
{% endtabs %}

#### Response

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

#### Errors

* 201 - Not found - either tracker or retranslator are not found by provided ID
* 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions or some other reason.
* 219 - Not allowed for clones of the device – if tracker is a clone.
* 236 - Feature unavailable due to tariff restrictions – if there are no trackers with "retranslation" tariff feature available.
* 242 - There were errors during content validation – if `fake_device_id` is invalid for the retranslator protocol.

### list

List tracker retranslators bound to tracker with ID=`tracker_id`.

#### Parameters

| name        | description                                                                                      | type | format |
| ----------- | ------------------------------------------------------------------------------------------------ | ---- | ------ |
| tracker\_id | ID of the tracker (aka "object\_id"). Tracker must belong to authorized user and not be blocked. | int  | 999199 |

#### Examples

{% tabs %}
{% tab title="cURL" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/tracker/retranslator/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489}'
```

{% endtab %}

{% tab title="HTTP GET" %}
{% code overflow="wrap" %}

```http
https://api.eu.navixy.com/v2/tracker/retranslator/list?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489
```

{% endcode %}
{% endtab %}
{% endtabs %}

#### Response

```json
{
  "success": true,
  "list": [
    {
      "retranslator_id": 4548,
      "fake_device_id": "AI568T"
    }
  ]
}
```

#### Errors

* 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.

### unbind

Unbinds a tracker from retranslator.

**required sub-user rights:** `admin` (available only to master users).

#### Parameters

| name             | description                                                                                      | type | format |
| ---------------- | ------------------------------------------------------------------------------------------------ | ---- | ------ |
| tracker\_id      | ID of the tracker (aka "object\_id"). Tracker must belong to authorized user and not be blocked. | int  | 999199 |
| retranslator\_id | Retranslator ID.                                                                                 | int  | 123    |

#### Examples

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```sh
curl -X POST 'https://api.eu.navixy.com/v2/tracker/retranslator/unbind' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489, "retranslator_id": 123}'
```

{% endcode %}
{% endtab %}

{% tab title="HTTP GET" %}
{% code overflow="wrap" %}

```http
https://api.eu.navixy.com/v2/tracker/retranslator/unbind?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489&retranslator_id=123
```

{% endcode %}
{% endtab %}
{% endtabs %}

#### Response

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

#### Errors

* 208 - Device blocked – if tracker exists but was blocked due to tariff restrictions, or some other reason.
* 219 - Not allowed for clones of the device – if tracker is a clone.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://navixy.com/docs/navixy-api/user-api/backend-api/resources/tracking/tracker/retranslator.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.