---
metadata:
  - name: generator
    content: Diplodoc Platform v5.70.0
vcsPath: >-
  motorway/magacg/support/docs/src/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md
alternate:
  - href: >-
      https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md
    type: text/markdown
    title: Markdown version
  - href: https://yamagistrali.ru/docs/ru-x-ai/llms.txt
    rel: describedby
---
<div class="openapi">

# Найти узловые точки по адресу

<!-- markdownlint-disable-file -->

[Порядок работы для агента](https://yamagistrali.ru/docs/ru-x-ai/concepts/agent-workflow.md) · [Методы API и схема OpenAPI](https://yamagistrali.ru/docs/ru-x-ai/methods/index.md).

## Назначение

Передайте `data.address`. Для поиска заведённой точки нужен `data.forwarderId` организации, в которой есть право `can_exp_create_nodal_point`. Без него метод не ищет заведённые точки. Найдите вариант с заполненным `nodalPoint` в `data.foundAddresses`.

> Блоки запроса и ответов ниже сгенерированы из OpenAPI. Подстановки вроде `example` показывают структуру JSON. Для вызова возьмите значения из сценария, справочников или предыдущих ответов API.

## Request

<div class="openapi__requests">

<div class="openapi__request__wrapper" style="--method: var(--dc-openapi-methods-post);margin-bottom: 12px">

<div class="openapi__request">

POST {.openapi__method}
```text translate=no
https://partner-test-yamagistrali.ru/api/nodalPoint/suggestWithGeoDataByAddress/v0
```

</div>

Тестовый стенд

</div>

</div>

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "data": {
    "address": "example",
    "forwarderId": "example"
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_data_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [NodalPointSuggestWithGeoDataByAddressV0Request](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0Request)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "address": "example",
  "forwarderId": "example"
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0Request {#entity-NodalPointSuggestWithGeoDataByAddressV0Request}

#|
|| **Name** | **Description** ||
||

_address_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_forwarderId_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "address": "example",
  "forwarderId": "example"
}
```

{% endcut %}

</div>

## Responses

<div class="openapi__response__code__200">

## 200 OK

OK

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "data": {
    "foundAddresses": [
      {
        "accuracy": "example",
        "address": "example",
        "area": "example",
        "displayAddress": "example",
        "house": "example",
        "lat": 0.5,
        "locality": "example",
        "lon": 0.5,
        "nodalPoint": {},
        "province": "example",
        "street": "example"
      }
    ]
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_data_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [NodalPointSuggestWithGeoDataByAddressV0Response](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0Response)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "foundAddresses": [
    {
      "accuracy": "example",
      "address": "example",
      "area": "example",
      "displayAddress": "example",
      "house": "example",
      "lat": 0.5,
      "locality": "example",
      "lon": 0.5,
      "nodalPoint": {
        "addressComment": "example",
        "createdAt": "2025-07-22T20:21:19.773333823Z",
        "forwarderId": "example",
        "id": "example",
        "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
        "legalAddress": "example",
        "legalPhone": "example",
        "nodalPointContacts": [
          null
        ],
        "npCountry": "example",
        "npLegalType": "example",
        "npName": "example",
        "npTin": "example",
        "timezoneIdentifier": "example",
        "transshipmentTypes": [
          null
        ],
        "utcOffset": "example"
      },
      "province": "example",
      "street": "example"
    }
  ]
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0PersonalData {#entity-NodalPointSuggestWithGeoDataByAddressV0PersonalData}

#|
|| **Name** | **Description** ||
||

_email_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_name_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_phone_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "email": "example",
  "id": "example",
  "name": "example",
  "phone": "example"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0NodalPointContact {#entity-NodalPointSuggestWithGeoDataByAddressV0NodalPointContact}

#|
|| **Name** | **Description** ||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_npId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_personalData_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: [NodalPointSuggestWithGeoDataByAddressV0PersonalData](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0PersonalData)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "email": "example",
  "id": "example",
  "name": "example",
  "phone": "example"
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "id": "example",
  "npId": "example",
  "personalData": {
    "email": "example",
    "id": "example",
    "name": "example",
    "phone": "example"
  }
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0NodalPoint {#entity-NodalPointSuggestWithGeoDataByAddressV0NodalPoint}

#|
|| **Name** | **Description** ||
||

_createdAt_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `2025-07-22T20:21:19.773333823Z`
{.table-cell}
||
||

_forwarderId_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_id_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_lastUsedAt_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `2025-07-22T20:21:19.773333823Z`
{.table-cell}
||
||

_npLegalType_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_npName_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_npTin_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_timezoneIdentifier_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_utcOffset_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_addressComment_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_legalAddress_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_legalPhone_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_nodalPointContacts_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [NodalPointSuggestWithGeoDataByAddressV0NodalPointContact](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0NodalPointContact)[] &#124; null

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "id": "example",
    "npId": "example",
    "personalData": {
      "email": "example",
      "id": "example",
      "name": "example",
      "phone": "example"
    }
  }
]
```

{% endcut %}
{.table-cell}
||
||

_npCountry_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_transshipmentTypes_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string[] &#124; null

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  "example"
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "addressComment": "example",
  "createdAt": "2025-07-22T20:21:19.773333823Z",
  "forwarderId": "example",
  "id": "example",
  "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
  "legalAddress": "example",
  "legalPhone": "example",
  "nodalPointContacts": [
    {
      "id": "example",
      "npId": "example",
      "personalData": {
        "email": "example",
        "id": "example",
        "name": "example",
        "phone": "example"
      }
    }
  ],
  "npCountry": "example",
  "npLegalType": "example",
  "npName": "example",
  "npTin": "example",
  "timezoneIdentifier": "example",
  "transshipmentTypes": [
    "example"
  ],
  "utcOffset": "example"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0FoundAddress {#entity-NodalPointSuggestWithGeoDataByAddressV0FoundAddress}

#|
|| **Name** | **Description** ||
||

_accuracy_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

уровень точности

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_address_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

адрес, например `Калужское шоссе, 22-й километр, 10`

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_displayAddress_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: string

адрес для основного отображения, например `Фудсити`, или `Москва, ул. Медиков, д 18`

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_lat_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number

широта
{.table-cell}
||
||

_lon_{.json-schema-reset .json-schema-property .json-schema-required}
{.table-cell}|
**Type**: number

долгота
{.table-cell}
||
||

_area_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

район

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_house_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

дом

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_locality_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

город

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_nodalPoint_{.json-schema-reset .json-schema-property}
{.table-cell}|
{% cut "**Any of 2 types**" %}{.json-schema-combinators data-marker=or}

- **Type**: [NodalPointSuggestWithGeoDataByAddressV0NodalPoint](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0NodalPoint)

  {% cut "**Example**" %}{.json-schema-example}

  ```json translate=no
  {
    "addressComment": "example",
    "createdAt": "2025-07-22T20:21:19.773333823Z",
    "forwarderId": "example",
    "id": "example",
    "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
    "legalAddress": "example",
    "legalPhone": "example",
    "nodalPointContacts": [
      {
        "id": "example",
        "npId": "example",
        "personalData": {
          "email": "example",
          "id": "example",
          "name": "example",
          "phone": "example"
        }
      }
    ],
    "npCountry": "example",
    "npLegalType": "example",
    "npName": "example",
    "npTin": "example",
    "timezoneIdentifier": "example",
    "transshipmentTypes": [
      "example"
    ],
    "utcOffset": "example"
  }
  ```

  {% endcut %}

- **Type**: object &#124; null

  _Const:_{.json-schema-reset .json-schema-value} `null`

  {% cut "**Example**" %}{.json-schema-example}

  ```json translate=no
  {}
  ```

  {% endcut %}

{% endcut %}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "addressComment": "example",
  "createdAt": "2025-07-22T20:21:19.773333823Z",
  "forwarderId": "example",
  "id": "example",
  "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
  "legalAddress": "example",
  "legalPhone": "example",
  "nodalPointContacts": [
    {
      "id": "example",
      "npId": "example",
      "personalData": {
        "email": "example",
        "id": "example",
        "name": "example",
        "phone": "example"
      }
    }
  ],
  "npCountry": "example",
  "npLegalType": "example",
  "npName": "example",
  "npTin": "example",
  "timezoneIdentifier": "example",
  "transshipmentTypes": [
    "example"
  ],
  "utcOffset": "example"
}
```

{% endcut %}
{.table-cell}
||
||

_province_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

провинция

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_street_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string &#124; null

улица

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "accuracy": "example",
  "address": "example",
  "area": "example",
  "displayAddress": "example",
  "house": "example",
  "lat": 0.5,
  "locality": "example",
  "lon": 0.5,
  "nodalPoint": {
    "addressComment": "example",
    "createdAt": "2025-07-22T20:21:19.773333823Z",
    "forwarderId": "example",
    "id": "example",
    "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
    "legalAddress": "example",
    "legalPhone": "example",
    "nodalPointContacts": [
      {
        "id": "example",
        "npId": "example",
        "personalData": {}
      }
    ],
    "npCountry": "example",
    "npLegalType": "example",
    "npName": "example",
    "npTin": "example",
    "timezoneIdentifier": "example",
    "transshipmentTypes": [
      "example"
    ],
    "utcOffset": "example"
  },
  "province": "example",
  "street": "example"
}
```

{% endcut %}

</div>

<div class="openapi-entity">

### NodalPointSuggestWithGeoDataByAddressV0Response {#entity-NodalPointSuggestWithGeoDataByAddressV0Response}

#|
|| **Name** | **Description** ||
||

_foundAddresses_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [NodalPointSuggestWithGeoDataByAddressV0FoundAddress](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-NodalPointSuggestWithGeoDataByAddressV0FoundAddress)[] &#124; null

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
[
  {
    "accuracy": "example",
    "address": "example",
    "area": "example",
    "displayAddress": "example",
    "house": "example",
    "lat": 0.5,
    "locality": "example",
    "lon": 0.5,
    "nodalPoint": {
      "addressComment": "example",
      "createdAt": "2025-07-22T20:21:19.773333823Z",
      "forwarderId": "example",
      "id": "example",
      "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
      "legalAddress": "example",
      "legalPhone": "example",
      "nodalPointContacts": [
        {}
      ],
      "npCountry": "example",
      "npLegalType": "example",
      "npName": "example",
      "npTin": "example",
      "timezoneIdentifier": "example",
      "transshipmentTypes": [
        "example"
      ],
      "utcOffset": "example"
    },
    "province": "example",
    "street": "example"
  }
]
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "foundAddresses": [
    {
      "accuracy": "example",
      "address": "example",
      "area": "example",
      "displayAddress": "example",
      "house": "example",
      "lat": 0.5,
      "locality": "example",
      "lon": 0.5,
      "nodalPoint": {
        "addressComment": "example",
        "createdAt": "2025-07-22T20:21:19.773333823Z",
        "forwarderId": "example",
        "id": "example",
        "lastUsedAt": "2025-07-22T20:21:19.773333823Z",
        "legalAddress": "example",
        "legalPhone": "example",
        "nodalPointContacts": [
          null
        ],
        "npCountry": "example",
        "npLegalType": "example",
        "npName": "example",
        "npTin": "example",
        "timezoneIdentifier": "example",
        "transshipmentTypes": [
          null
        ],
        "utcOffset": "example"
      },
      "province": "example",
      "street": "example"
    }
  ]
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__400">

## 400 Bad Request

Bad Request

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_error_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Error](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-Error)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "info": {},
  "message": "example",
  "message_code": "example"
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

<div class="openapi-entity">

### Error {#entity-Error}

#|
|| **Name** | **Description** ||
||

_info_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: object

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{}
```

{% endcut %}
{.table-cell}
||
||

_message_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
||

_message_code_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: string

_Example:_{.json-schema-reset .json-schema-example} `example`
{.table-cell}
||
|#{.json-schema-properties}

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "info": {},
  "message": "example",
  "message_code": "example"
}
```

{% endcut %}

</div>

</div>

<div class="openapi__response__code__403">

## 403 Forbidden

Forbidden

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_error_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Error](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-Error)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "info": {},
  "message": "example",
  "message_code": "example"
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

<div class="openapi__response__code__500">

## 500 Internal Server Error

Internal Server Error

<div class="openapi-entity">

### Body

{% cut "application/json" %}

```json translate=no
{
  "error": {
    "info": {},
    "message": "example",
    "message_code": "example"
  }
}
```

{% endcut %}

#|
|| **Name** | **Description** ||
||

_error_{.json-schema-reset .json-schema-property}
{.table-cell}|
**Type**: [Error](https://yamagistrali.ru/docs/ru-x-ai/methods/post-api-nodalpoint-suggestwithgeodatabyaddress-v0.md#entity-Error)

{% cut "**Example**" %}{.json-schema-example}

```json translate=no
{
  "info": {},
  "message": "example",
  "message_code": "example"
}
```

{% endcut %}
{.table-cell}
||
|#{.json-schema-properties}

</div>

</div>

</div>

[*Deprecated]: No longer supported, please use an alternative and newer version.