Documentation Index
Fetch the complete documentation index at: https://montereyfinancial.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Monterey provides campaign analytics through aggregated statistics, time-series data, and raw engagement events.
Campaign statistics
| Endpoint | Purpose |
|---|
GET /campaign-statistics/ | List statistics for all campaigns (optional date range filter) |
GET /campaign-statistics/{campaign_id} | Get statistics for a single campaign |
GET /campaign-statistics/{campaign_id}/time-series | Time-series breakdown |
Time-series granularity
The time-series endpoint accepts a granularity parameter:
| Value | Description |
|---|
hour | Hourly data points |
day | Daily aggregation |
week | Weekly aggregation |
month | Monthly aggregation |
curl "http://localhost:8000/campaign-statistics/{id}/time-series?granularity=day" \
-H "Authorization: Bearer <token>" \
-H "workspace_id: <workspace-id>"
Engagement events
Raw engagement events (opens, clicks, bounces) are available through the events API:
curl "http://localhost:8000/campaign-events/?event_type=open&date_from=2026-01-01" \
-H "Authorization: Bearer <token>" \
-H "workspace_id: <workspace-id>"
Bounce tracking
Real-time bounces
Bounce events from campaign sends are tracked automatically via webhooks. See webhooks.
| Endpoint | Purpose |
|---|
GET /bounce-events/ | List bounce events (filter by email, workspace) |
GET /bounce-events/{id} | Get bounce event details |
Historical bounces
The historical bounces API provides access to bounce records synced from Campaigner’s full history:
| Endpoint | Purpose |
|---|
GET /historical-bounces/ | List with filters for email, bounce type, account number, date range |
GET /historical-bounces/export | Export bounces as a CSV file |
POST /historical-bounces/backfill | Trigger a background sync from Campaigner |
The backfill endpoint dispatches a Celery task to sync bounce history. Pass full_backfill: true to sync all records, or use since for incremental updates.