# POST /event-schedules/preview-cron

**Resource:** [Event Schedules](./event-schedules.md)  
**Scopes:** `schedules:read`  
**Write operation:** no

Validate a cron expression and preview the next N fire times in a specified timezone. Does NOT create any schedule. Use to confirm a pattern before saving.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `cron_expression` | body | string | yes | Standard 5-field cron expression to validate |
| `timezone` | body | string | no | IANA timezone (default "Australia/Sydney") |
| `count` | body | number | no | Number of future fire times to return (1-20, default 5) |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/event-schedules/preview-cron" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "cron_expression": "0 9 * * 1-5",
    "timezone": "Australia/Sydney",
    "count": 3
  }'
```

## Response example

```json
{
  "data": {
    "cron_expression": "0 9 * * 1-5",
    "timezone": "Australia/Sydney",
    "next_runs": [
      "2026-04-21T23:00:00.000Z",
      "2026-04-22T23:00:00.000Z",
      "2026-04-23T23:00:00.000Z"
    ]
  },
  "meta": { "credits_remaining": 9986 }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`