---
title: "Gets a Lead's Events"
method: GET
path: "/Leads/{id}/Events"
tags: ["Leads"]
---

# Gets a Lead's Events

`GET /Leads/{id}/Events`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Leads/{id}/Events`
- Auth: none declared. Required headers: `Authorization`

## Path parameters

- `id` integer, required

## Query parameters

- `updated_after_utc` string, date-time
- `top` integer
- `skip` integer
- `brief` boolean
- `count_total` boolean

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- APIEvent[]
  - `EVENT_ID` integer
  - `TITLE` string, string
  - `LOCATION` string, string
  - `START_DATE_UTC` string, date-time, required
  - `END_DATE_UTC` string, date-time, required
  - `ALL_DAY` boolean
  - `DETAILS` string, string
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `REMINDER_DATE_UTC` string, date-time
  - `REMINDER_SENT` boolean
  - `OWNER_USER_ID` integer
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Authentication failed.
- `403`: API User does not have access to Record.
- `404`: Record not found.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)