метод REST scope: crm

crm.duplicate.findbycomm

Получить лиды, контакты и компании с совпадающими данными

Кто может выполнять: пользователь с правом на чтение элементов CRM

Описание

Метод crm.duplicate.findbycomm возвращает идентификаторы лидов, контактов и компаний, содержащих телефоны или email-адреса из заданного списка. Поиск не учитывает добавочный номер телефона.

Параметры

type string обязательный

Тип коммуникации. Возможные значения:
- EMAIL — email-адрес
- PHONE — телефон

values string[] обязательный

Массив email или телефонов.

Максимальное количество значений — 20

entity_type string необязательный

Тип объекта. Возможные значения:
- LEAD — лид
- CONTACT — контакт
- COMPANY — компания

Если не задан — поиск выполняется по всем трем типам

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

curl -X POST \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"entity_type":"CONTACT","type":"PHONE","values":["8976543","11223355"]}' \
     https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.duplicate.findbycomm

Ответ

HTTP-статус: 200

{
    "result": {
        "CONTACT": [275, 2297]
    },
    "time": {
        "start": 1750684060.672785,
        "finish": 1750684060.724903,
        "duration": 0.05211806297302246,
        "processing": 0.018191099166870117,
        "date_start": "2025-06-23T16:07:40+03:00",
        "date_finish": "2025-06-23T16:07:40+03:00",
        "operating_reset_at": 1750684660,
        "operating": 0
    }
}

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

LEAD integer[]

Массив идентификаторов найденных лидов

CONTACT integer[]

Массив идентификаторов найденных контактов

COMPANY integer[]

Массив идентификаторов найденных компаний

time time

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

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

HTTP-статус: 400

{
    "error": "Communication type is not defined",
    "error_description": "Parameter 'type' is required."
}
Код Описание Значение
403 Access denied У пользователя нет прав на чтение элементов CRM
400 Communication type is not defined Не указан обязательный параметр type
400 Communication type '{type}' is not supported in current context Указан неподдерживаемый тип коммуникации
400 Communication values is not defined Не указан обязательный параметр values

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

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