Получить аккаунты

GET /accounts

Аутентификация

Передавайте API-ключ организации как Bearer-токен.

Authorization: Bearer YOUR_API_KEY

Ответ

application/json

Аккаунты успешно получены

items object[] обязательное

Список учетных записей пользователей

Показать вложенные поля Скрыть вложенные поля

items.id number обязательное

ID аккаунта

Пример: 1

items.email string обязательное

Электронная почта аккаунта

Пример: user@example.com

items.first_name string обязательное

Имя

Пример: John

items.last_name string обязательное

Фамилия

Пример: Doe

items.warmup boolean обязательное

Включен ли прогрев

Пример: true

items.warmup_last_date_send string обязательное

Последняя дата, когда разминка отправила email-сообщение

Пример: 2025-09-20T12:00:00.000Z

items.last_type_send_email string обязательное

Тип последнего отправленного письма

Пример: warmup

items.warmup_start_date string обязательное

Дата начала разминки

Пример: 2025-09-10T10:00:00.000Z

items.warmup_sent_today number обязательное

Количество разогревающих писем, отправленных сегодня

Пример: 5

items.warmup_daily_limit number обязательное

Дневной лимит разминки

Пример: 20

items.warmup_starting_email_number number обязательное

Начальный номер email для разминки

Пример: 1

items.expected_to_send_warmup_emails number обязательное

Ожидается отправка разминочных писем

Пример: 50

items.service string обязательное

Сервис (google, yandex и т.д.)

Пример: google

items.limit number обязательное

Лимит отправки в день

Пример: 50

items.sent_today number обязательное

Отправлено сегодня

Пример: 10

items.total_sent number обязательное

Всего отправленных писем

Пример: 300

items.id_previous_sending_campaign number обязательное

ID предыдущей рассылки отправки

Пример: 123

items.cooldown_start number обязательное

Начало перезарядки (секунды)

Пример: 180

items.cooldown_end number обязательное

Окончание перезарядки (секунды)

Пример: 360

items.is_account_ready string обязательное

Дата готовности аккаунта

Пример: 2025-09-18T09:00:00.000Z

items.user_id number обязательное

Пользователь ID, владеющий учетной записью

Пример: 42

items.tags string[] обязательное

Теги, присвоенные аккаунту

Пример: ["Disconnected", "Bounce"]

items.last_block_account_date string обязательное

Дата последней блокировки аккаунта

Пример: 2025-09-21T14:00:00.000Z

items.error_text string обязательное

Текст ошибки, если учетная запись не удалось подключиться

Пример: Invalid credentials

items.signature string обязательное

Подпись, прикрепленная к исходящим электронным письмам

Пример: Best regards, John

Запрос

curl --request GET \
  --url https://developer.coldy.ai/api/v1/accounts \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json'

{
  "items": [
    {
      "id": 1,
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe",
      "warmup": true,
      "warmup_last_date_send": "2025-09-20T12:00:00.000Z",
      "last_type_send_email": "warmup",
      "warmup_start_date": "2025-09-10T10:00:00.000Z",
      "warmup_sent_today": 5,
      "warmup_daily_limit": 20,
      "warmup_starting_email_number": 1,
      "expected_to_send_warmup_emails": 50,
      "service": "google",
      "limit": 50,
      "sent_today": 10,
      "total_sent": 300,
      "id_previous_sending_campaign": 123,
      "cooldown_start": 180,
      "cooldown_end": 360,
      "is_account_ready": "2025-09-18T09:00:00.000Z",
      "user_id": 42,
      "tags": [
        "Disconnected",
        "Bounce"
      ],
      "last_block_account_date": "2025-09-21T14:00:00.000Z",
      "error_text": "Invalid credentials",
      "signature": "Best regards, John"
    }
  ]
}

{
  "message": [
    "You put invalid API key. Verify your key with the key from your account in Coldy. Check documenation for info"
  ],
  "statusCode": 400,
  "error": "Invalid API key"
}