List Appointment Types

Retrieve available appointment types for your organization

GET/calendar/appointment-types

Requires Bearer authentication

Retrieve all appointment types configured for your organization. Appointment types define the services you offer (e.g., "Tax Consultation", "Strategy Call").

GET/calendar/appointment-types

curl -X GET "https://api.vastal.agency/v1/calendar/appointment-types" \
-H "Authorization: Bearer YOUR_API_KEY"

200Success

{
"appointmentTypes": [
  {
    "id": "type_abc123",
    "orgId": "org_xyz789",
    "name": "Tax Consultation",
    "description": "One-on-one tax planning session",
    "durationMinutes": 60,
    "color": "#3b82f6",
    "bufferBeforeMinutes": 15,
    "bufferAfterMinutes": 15,
    "maxPerDay": 8,
    "maxPerWeek": null,
    "maxPerMonth": null,
    "minNoticeHours": 24,
    "maxDaysAhead": 60,
    "requiresConfirmation": false,
    "confirmWithinHours": null,
    "bookingQuestions": [
      {
        "id": "q1",
        "type": "text",
        "label": "What topics would you like to discuss?",
        "required": true
      }
    ],
    "scheduleId": "sched_def456",
    "scheduleName": "Business Hours",
    "isActive": true,
    "sortOrder": 1,
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2024-01-15T10:30:00Z"
  }
]
}