Контакты

Контакты в списке

Возвращает пагинированный список контактов указанного списка, включая значения переменных.

get/v1/public/lists/{listId}/contacts

Request

  • Base URL: https://api.rusender.ru/api
  • URL: https://api.rusender.ru/api/v1/public/lists/{listId}/contacts
  • Auth: HTTP bearer

Path parameters

listIdinteger required

Уникальный идентификатор списка.

Query parameters

emailstring
Example:john@example.com

Фильтр по точному email.

statusstring[]

Фильтр по статусам контактов.

sortBy'id' | 'email' | 'createdAt' | 'updatedAt' | 'lastActivityAt'

Поле для сортировки.

sortDir'asc' | 'desc'

Направление сортировки (asc или desc).

Response

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

okboolean required

Флаг успешного выполнения.

Example response

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": 42,
        "email": "john@example.com",
        "name": "John Doe",
        "phone": "+79001234567",
        "status": "active",
        "listIds": [
          1,
          5
        ],
        "lists": [
          {
            "id": 1,
            "name": "Newsletter subscribers"
          }
        ],
        "variables": {
          "city": "Moscow",
          "birthday": "1990-05-15"
        },
        "createdAt": "2026-01-15T10:30:00.000Z",
        "updatedAt": "2026-03-01T14:00:00.000Z"
      }
    ]
  },
  "meta": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-05T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "limit": 20,
      "totalItems": 150,
      "totalPages": 8
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.