> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getnexor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Lead Meetings

<span class="badge--get">GET</span> <code class="endpoint-url">/leads/\{id}/meetings</code>

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.

Authenticate every request with the `X-API-Key` header. See [Authentication](/docs/en/api/authentication).

## 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` |

## Responses

### `200` Meetings retrieved successfully

```json theme={null}
{
  "success": true,
  "meetings": [
    {
      "id": "event-uuid",
      "title": "Intro call with Tony Stark",
      "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": "Pepper Potts",
      "meeting_type": "Google Meet",
      "attendee_name": "Tony Stark",
      "attendee_email": "tony.stark@gmail.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 (for example, "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](/docs/en/api/authentication).

### `404` Lead not found

```json theme={null}
{
  "error": "Lead not found or does not belong to your account"
}
```

### `500` Internal server error