Get Lead Meetings

GET /leads/{id}/meetings

Returns all meetings (calendar events) for a lead, sorted by most recent first. Use this to display upcoming appointments, past meeting history, and no-show records in your CRM.

Path Parameters

Parameter	Type	Required	Description
id	string (uuid)	Yes	Lead ID

Query Parameters

Parameter	Type	Description
status	string	Comma-separated status filter: scheduled, confirmed, completed, cancelled, no_show

Examples

# All meetings
curl https://api.getnexor.ai/api/public/leads/550e8400-e29b-41d4-a716-446655440000/meetings \
  -H "X-API-Key: nxr_live_your_api_key"

# Only upcoming (scheduled + confirmed)
curl "https://api.getnexor.ai/api/public/leads/550e8400-e29b-41d4-a716-446655440000/meetings?status=scheduled,confirmed" \
  -H "X-API-Key: nxr_live_your_api_key"

Responses

200 — Meetings retrieved successfully

{
  "success": true,
  "meetings": [
    {
      "id": "event-uuid",
      "title": "Investment Advisory - John Doe",
      "starts_at": "2026-04-10T15:00:00Z",
      "ends_at": "2026-04-10T15:30:00Z",
      "duration_minutes": 30,
      "timezone": "America/Santiago",
      "status": "scheduled",
      "meeting_url": "https://meet.google.com/abc-xyz-123",
      "location_type": "video",
      "location_details": null,
      "host_name": "Maria Garcia",
      "meeting_type": "Google Meet",
      "attendee_name": "John Doe",
      "attendee_email": "john@example.com",
      "confirmed_by_lead": false,
      "cancelled_at": null,
      "cancellation_reason": null,
      "no_show_reason": null,
      "outcome_notes": null,
      "created_at": "2026-04-08T10:00:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
id	string (uuid)	Meeting identifier
title	string	Meeting title
starts_at	string (date-time)	Start time (UTC)
ends_at	string (date-time)	End time (UTC)
duration_minutes	integer	Duration in minutes
timezone	string	Timezone used when booking
status	string	scheduled, confirmed, completed, cancelled, or no_show
meeting_url	string | null	Video call URL (Google Meet, Zoom, etc.)
location_type	string	video, phone, or in_person
location_details	string | null	Additional location info
host_name	string | null	Assigned host/agent name
meeting_type	string | null	Meeting type name (e.g., "Google Meet", "Initial Consultation")
attendee_name	string	Lead's name as registered
attendee_email	string	Lead's email as registered
confirmed_by_lead	boolean	Whether the lead confirmed attendance
cancelled_at	string | null	When the meeting was cancelled
cancellation_reason	string | null	Why it was cancelled
no_show_reason	string | null	Reason for no-show (if applicable)
outcome_notes	string | null	Post-meeting notes
created_at	string (date-time)	When the meeting was created

401 — Authentication error

See Authentication.

404 — Lead not found

{
  "error": "Lead not found or does not belong to your account"
}

500 — Internal server error