метод REST scope: crm

crm.contact.company.items.get

Получить набор компаний, связанных с указанным контактом

Кто может выполнять: любой пользователь с правом «чтения» контактов

Описание

Метод crm.contact.company.items.get возвращает набор компаний, связанных с указанным контактом.

Параметры

id integer обязательный

Идентификатор контакта.

Идентификатор можно получить с помощью методов crm.contact.list или crm.contact.add

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":54}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.contact.company.items.get

Ответ

HTTP-статус: 200

{
    "result": [
        {
        "COMPANY_ID": 7,
        "SORT": 100,
        "ROLE_ID": 0,
        "IS_PRIMARY": "Y"
        },
        {
        "COMPANY_ID": 8,
        "SORT": 110,
        "ROLE_ID": 0,
        "IS_PRIMARY": "N"
        },
        {
        "COMPANY_ID": 9,
        "SORT": 120,
        "ROLE_ID": 0,
        "IS_PRIMARY": "N"
        }
    ],
    "time": {
        "start": 1724078791.470108,
        "finish": 1724078791.969407,
        "duration": 0.4992990493774414,
        "processing": 0.19150400161743164,
        "date_start": "2024-08-19T16:46:31+02:00",
        "date_finish": "2024-08-19T16:46:31+02:00"
    }
}

Возвращаемые данные

result contact_company_binding[]

Корневой элемент ответа. Содержит массив с информацией о привязанных к контакту компаниях

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 200

{
    "error": "",
    "error_description": "The parameter ownerEntityID is invalid or not defined."
}
Код Описание Значение
The parameter 'ownerEntityID' is invalid or not defined Передан id меньше 0 или не передан вовсе
ACCESS_DENIED Access denied! У пользователя нет прав на чтение контактов

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.