# POST /scheduling-bookings/check-availability

**Resource:** [Scheduling Bookings](./scheduling-bookings.md)  
**Scopes:** `company:read`  
**Write operation:** no

Quick check if a specific date/time slot is available. Always returns nearest_before and nearest_after slots -- perfect for conversational booking flows.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `event_type_id` | body | string | no | Event type UUID (or slug/name) |
| `event_type_slug` | body | string | no | Event type slug |
| `event_type_name` | body | string | no | Event type name |
| `date` | body | string | yes | Date to check YYYY-MM-DD |
| `time` | body | string | yes | Time to check HH:MM (24h) |
| `timezone` | body | string | no | Timezone. Default: Australia/Sydney |

## Request example

```bash
curl -X POST \
  "https://api.trustpager.com/functions/v1/api/v1/scheduling-bookings/check-availability" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type_slug": "30-minute-booking",
    "date": "2026-04-03",
    "time": "10:00",
    "timezone": "Australia/Sydney"
  }'
```

## Response example

```json
{
  "data": {
    "available": true,
    "slot": {
      "date": "2026-04-03",
      "time": "10:00",
      "formatted": "Thursday, 3 April 2026 at 10:00 AM",
      "duration_minutes": 30
    },
    "nearest_before": {
      "date": "2026-04-03",
      "time": "09:30",
      "formatted": "Thursday, 3 April at 9:30 AM"
    },
    "nearest_after": {
      "date": "2026-04-03",
      "time": "10:30",
      "formatted": "Thursday, 3 April at 10:30 AM"
    },
    "hint": "This slot is available. Use POST /scheduling-bookings to confirm."
  }
}
```

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