Availability

The Availability API lets you check free/busy schedules and find optimal meeting times using AI-powered recommendations.

Get Availability

GET/v1/availability

Returns the authenticated user's free and busy time slots for a given date.

Query Parameters

Parameter	Type	Description
`date`required	`string`	Date to check availability for, in ISO 8601 format (e.g., "2025-06-15") or relative format (e.g., "today", "tomorrow", "next Monday").

Example Request

curl https://api.meetsynced.com/v1/availability?date=2025-06-15 \
  -H "Authorization: Bearer sk_live_your_api_key"

Example Response

{
  "date": "2025-06-15",
  "timezone": "America/New_York",
  "slots": [
    { "start": "09:00", "end": "10:30", "status": "free" },
    { "start": "10:30", "end": "11:00", "status": "busy" },
    { "start": "11:00", "end": "12:00", "status": "free" },
    { "start": "12:00", "end": "13:00", "status": "busy" },
    { "start": "13:00", "end": "17:00", "status": "free" }
  ]
}

Get Recommended Slots

POST/v1/availability/recommended

Finds optimal meeting times across multiple participants. Optionally uses AI to rank slots by scheduling preferences.

Body Parameters

Parameter	Type	Description
`participants`required	`string[]`	Array of email addresses for the meeting participants. Availability is checked across all participants.
`duration`required	`string`	Desired meeting duration. One of "15 mins", "30 mins", "45 mins", "1 hour", "1.5 hours", or "2 hours".
`timeRange`	`string`	Preferred time of day. One of "morning", "afternoon", "evening", or "any". Defaults to "any".
`useAI`	`boolean`	When true, uses AI to rank slots based on participant scheduling patterns and preferences. Defaults to false.

AI-powered ranking

When useAI is enabled, Synced analyzes past scheduling patterns to recommend times when participants are most likely to accept. This endpoint has a lower rate limit of 10 requests per minute.

Example Request

curl -X POST https://api.meetsynced.com/v1/availability/recommended \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": ["alice@acme.com", "bob@acme.com"],
    "duration": "30 mins",
    "timeRange": "morning",
    "useAI": true
  }'

Example Response

{
  "slots": [
    {
      "start": "2025-06-16T09:00:00Z",
      "end": "2025-06-16T09:30:00Z",
      "score": 0.95,
      "reason": "Both participants are typically free at this time"
    },
    {
      "start": "2025-06-16T10:00:00Z",
      "end": "2025-06-16T10:30:00Z",
      "score": 0.82,
      "reason": "Good availability, slightly outside preferred hours for one participant"
    },
    {
      "start": "2025-06-17T09:30:00Z",
      "end": "2025-06-17T10:00:00Z",
      "score": 0.78,
      "reason": "Available but next day"
    }
  ]
}

Participant visibility

Recommended slots are only available for participants who are in your trusted contacts or who have granted you visibility into their calendar. For unknown participants, only your own availability is considered.