# Calltouch API: GET /calls-service/RestAPI/requests — Журнал заявок

Пример:

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `clientApiId` | query | string | да | API-токен |
| `siteId` | query | integer | да | ID личного кабинета |
| `dateFrom` | query | string | нет | Начало, mm/dd/yyyy (обязателен, если нет requestId/requestNumber) |
| `dateTo` | query | string | нет | Конец, mm/dd/yyyy |
| `requestId` | query | string | нет | ID заявок в Calltouch через запятую |
| `requestNumber` | query | string | нет | Внешние ID заявок |
| `attribution` | query | integer | нет | Модель атрибуции |
| `bindTo` | query | string | нет | request (по умолчанию) или session |
| `subject` | query | string | нет | Название формы |
| `withRequestTags` | query | boolean | нет | Выгрузить теги |
| `withMapVisits` | query | boolean | нет | Выгрузить историю посещений |
| `withCustomFields` | query | boolean | нет | Выгрузить пользовательские поля |

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

```
https://api.calltouch.ru/calls-service/RestAPI/requests/?clientApiId=<TOKEN>&requestId=79825254
```

## Базовые URL

- Боевой: `https://api.calltouch.ru`
- Методы: `/calls-service/RestAPI/`

## Авторизация

Тип: API-ключ

API-токен (45 символов) и `siteId` (ID личного кабинета) берутся в разделе «Интеграции» → «API». Токен передаётся параметром `clientApiId`. Для создания заявок с сайта токен не нужен.

```
https://api.calltouch.ru/calls-service/RestAPI/{siteId}/calls-diary/calls?clientApiId={токен}&dateFrom=22/11/2016&dateTo=22/11/2016&withCallTags=true&withMapVisits=true
```

## Нюансы

- Имена параметров чувствительны к регистру.
- Форматы дат различаются: журнал звонков — `dd/mm/yyyy`, журнал заявок — `mm/dd/yyyy`, создание заявки — `dd.mm.yyyy hh:mm:ss`.
- Данные Яндекс Директа и Google Ads появляются на следующий день после звонка; теги Predict и Antifrod — примерно через неделю.
- Каждый ответ содержит заголовок `Api-Point`: «потрачено / осталось часовых / осталось суточных», например `Api-Point: 4/5256/102368`.
- Поля ответа, не описанные в документации, устарели — их нужно игнорировать.

## Сценарии с этим методом

- [Передать заявку с сайта в Calltouch](https://mcp-everything.ru/integrations/calltouch/scenarios/peredat-zayavku-s-sayta-v-calltouch.md)

---

Если этого недостаточно — официальная документация: https://www.calltouch.ru/support/api-metod-vygruzki-zhurnala-zvonkov/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/calltouch.md