---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/direct/doc/en/businesses/get.md
  - https://yandex.com/dev/direct/doc/ru/businesses/get.md
  - href: ru/businesses/get.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/ref-v5/businesses/get.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/direct/doc/ru/llms.txt

# get

Возвращает данные [профилей организаций](https://yandex.ru/support/sprav/general/displaying.html#displaying__profile) пользователя на Яндексе.
Пользователь может получить данные организаций, для которых выполнено хотя бы одно из условий:

- У [главного представителя](https://yandex.ru/dev/direct/doc/dg/objects/roles.html) пользователя [подтверждены права](https://yandex.ru/support/sprav/manage/verify.html) на организацию в Яндекс Бизнесе.
- Профиль организации привязан к одному из объявлений пользователя.

Если профиль организации не прошел модерацию в Яндекс Бизнесе, в параметре `IsPublished` возвращается значение NO. Профиль такой организации нельзя привязать к объявлению.

### Узнайте больше {#see-also}

- [Как работает метод get](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html)


## Запрос {#input}

Структура запроса в формате JSON:

```javascript translate=no
{
  "method": "get",
  "params": { /* params */
    "SelectionCriteria": {  /* IdsCriteria */
      "Ids": [(long), ... ] /* required */
    },
    "FieldNames": [( "Id" | "Name" | "Address" | "Phone"
                     | "ProfileUrl" | "InternalUrl" | "IsPublished"
                     | "MergedIds" | "Rubric" | "Urls"
                     | "HasOffice" ), ... ], /* required */
    "Page": {  /* LimitOffset */
      "Limit": (long),
      "Offset": (long)
    }
  }
}
```

#|
|| **Параметр** | **Тип** | **Описание** | **Обязательный** ||

|| **Структура params (для JSON) / GetRequest (для SOAP)** | > | > | > ||

|| `SelectionCriteria` | IdsCriteria | Критерии отбора профилей организаций.  | Нет ||

|| `FieldNames` | array of BusinessFieldEnum | Имена параметров, которые требуется получить.  | Да ||

|| `Page` | LimitOffset | Структура, задающая страницу при [постраничной выборке](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html) данных.  | Нет ||

|| **Структура IdsCriteria** | > | > | > ||

|| `Ids` | array of long | Идентификаторы профилей организаций, которые требуется получить (не более 10 000).  | Да ||
|# 


## Ответ {#output}

Структура ответа в формате JSON:

```javascript translate=no
{
  "result": { /* result */
    "Businesses": [{ /* BusinessGetItem */
      "Id": (long),
      "Name": (string),
      "Address": (string), /* nillable */
      "Phone": (string),
      "ProfileUrl": (string),
      "InternalUrl": (string),
      "IsPublished": ( "YES" | "NO" ),
      "MergedIds": {  /* ArrayOfLong */
        "Items": [(long), ... ]
      },
      "Rubric": (string),
      "Urls": {  /* ArrayOfString */
        "Items": [(string), ... ]
      },
      "HasOffice": ( "YES" | "NO" )
    }, ... ],
    "LimitedBy": (long)
  }
}
```

#|
|| **Параметр** | **Тип** | **Описание** ||

|| **Структура result (для JSON) / GetResponse (для SOAP)** | > | > ||

|| `Businesses` | array of BusinessGetItem | Профили организаций.  ||

|| `LimitedBy` | long | Порядковый номер последнего возвращенного объекта. Передается в случае, если количество объектов в ответе было ограничено лимитом. См. раздел [Постраничная выборка](https://yandex.ru/dev/direct/doc/dg/best-practice/get.html).  ||

|| **Структура BusinessGetItem** | > | > ||

|| `Id` | long | Идентификатор профиля организации.  ||

|| `Name` | string | Название организации.  ||

|| `Address` | string, nillable | Адрес организации.  ||

|| `Phone` | string | Телефон организации.  ||

|| `ProfileUrl` | string | Ссылка на профиль организации на Яндексе.  ||

|| `InternalUrl` | string | Ссылка на страницу редактирования организации в Бизнесе.  ||

|| `IsPublished` | YesNoEnum | Признак того, что профиль организации прошел модерацию в Яндекс Справочнике и опубликован.

Профиль организации можно привязать к объявлению, только если для него в параметре `IsPublished` возвращается значение YES.  ||

|| `MergedIds` | ArrayOfLong | Идентификаторы профилей организаций, которые объединены с основным профилем (идентификатор основного профиля указан в поле `Id`).

Возвращаются только идентификаторы профилей, привязанных к объявлениям пользователя, и только если в запросе отсутствовал `SelectionCriteria`.  ||

|| `Rubric` | string | Род деятельности организации.  ||

|| `Urls` | ArrayOfString | Ссылки на сайт и социальные сети.  ||

|| `HasOffice` | YesNoEnum | Признак того, что организация имеет фактический адрес.  ||
|#