# Best send time

> **TL;DR for agents:** `POST /api/best-send-time {timezone | contactId, windowHours}` returns one or more send-window candidates ranked by historical reply rate.

## Resolve by timezone

```bash
curl -s -X POST "https://api.live-direct-marketing.online/api/best-send-time" \
  -H "Authorization: Bearer $LDM_KEY" -H "Content-Type: application/json" \
  -d '{"timezone":"Europe/Moscow","windowHours":24}'
```

## Resolve by contact (uses their TZ + historical opens)

```bash
curl -s -X POST "https://api.live-direct-marketing.online/api/best-send-time" \
  -H "Authorization: Bearer $LDM_KEY" -H "Content-Type: application/json" \
  -d '{"contactId":"$CONTACT_ID","windowHours":48}'
```