> For the complete documentation index, see [llms.txt](https://help.onebot.tech/onebot-help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.onebot.tech/onebot-help/rabota-s-api-platformy/kontakty.md).

# Контакты

## Получить список контактов

<mark style="color:blue;">`GET`</mark> `https://app.onebot.tech/api/v1/getContacts`

Этот метод позволяет получить список контактов указанного бота

#### Path Parameters

| Name       | Type    | Description                                                                                                          |
| ---------- | ------- | -------------------------------------------------------------------------------------------------------------------- |
| date\_from | Integer | Фильтр по дате создания контакта в формате Unix Time                                                                 |
| date\_to   | Integer | Фильтр по дате создания контакта в формате Unix Time                                                                 |
| count      | Integer | Количество контактов для получения. Максимальное значение: 500                                                       |
| with       | String  | Список дополнительных сущностей для контакта, передается в виде перечисления через запятую. Пример: `tags,variables` |
| bot\_id    | Integer | ID бота                                                                                                              |

{% tabs %}
{% tab title="200: OK Запрос успешно обработан." %}

```javascript
{
  "data": [
    {
      "id": 1,
      "bot_id": 1,
      "phone": "380500505555",
      "email": "info@example.com",
      "name": "Иван Иванов",
      "messenger": "whatsapp",
      "address": "г. Киев, Степана Бандеры, д. 5",
      "utm": {
        "utm_source": "landing",
        "utm_medium": "...",
        "utm_campaign": "...",
        "utm_term": "...",
        "utm_content": "..."
      },
      "created_at": "2022-11-11T10:38:28+00:00"
    },
    {
      "id": 2,
      "bot_id": 1,
      "phone": "380660888007",
      "email": null,
      "name": "Петр Петров",
      "messenger": "telegram",
      "telegram_id": "123456",
      "telegram_username": "superman",
      "address": null,
      "utm": null,
      "created_at": "2022-11-11T12:16:16+00:00"
    },
    {
      "id": 3,
      "bot_id": 2,
      "phone": null,
      "email": null,
      "name": "Василий Васильев",
      "messenger": "viber",
      "viber_id": "1123456789dD20=",
      "address": null,
      "utm": null,
      "created_at": "2022-11-11T15:31:34+00:00"
    },
  ],
  "links": {
    "first": "http:\/\/onebot.tech\/api\/v1\/getContacts?page=1",
    "last": "http:\/\/onebot.tech\/api\/v1\/getContacts?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "http:\/\/onebot.tech\/api\/v1\/getContacts",
    "per_page": 500,
    "to": 3,
    "total": 3
  }
}
```

{% endtab %}
{% endtabs %}

{% content-ref url="/pages/z6oa9Z1ZGPRGhvLADbzY" %}
[Счета](/onebot-help/rabota-s-api-platformy/kontakty/scheta.md)
{% endcontent-ref %}

{% content-ref url="/pages/DySm7FtWuiuMwAqZM5RI" %}
[Счета в криптовалюте](/onebot-help/rabota-s-api-platformy/kontakty/scheta-v-kriptovalyute.md)
{% endcontent-ref %}

{% content-ref url="/pages/HcMDARWhIPwmz4RsWkp1" %}
[Реферальная система](/onebot-help/rabota-s-api-platformy/kontakty/referalnaya-sistema.md)
{% endcontent-ref %}

{% content-ref url="/pages/Bs5qsPzqDbAekg1ykVyH" %}
[Теги](/onebot-help/rabota-s-api-platformy/kontakty/tegi.md)
{% endcontent-ref %}

{% content-ref url="/pages/NE2WzaI5hXT5XBKONRR7" %}
[Пользовательские переменные](/onebot-help/rabota-s-api-platformy/kontakty/polzovatelskie-peremennye.md)
{% endcontent-ref %}