---
title: "List Appointments"
method: GET
path: "/v1.0/appts"
tags: ["Tasks & Appointments"]
---

# List Appointments

`GET /v1.0/appts`

Returns appointments attached to the given lead. Caller must have manage permission on the lead.

## Query parameters

- `leadId` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Appointments for the lead.

- Appointment[]
  - `id` integer — The Id of the appointment
  - `descr` string — The description of the appointment
  - `address` string — The location of the appointment
  - `createTime` string, date-time — The create time of the appointment
  - `lastUpdate` string, date-time — The last update time of the appointment
  - `deadline` integer — The start time of the appointment
  - `endTime` integer — The end time of the appointment
  - `allDay` boolean — Whether the appointment time is all day
  - `finishFlag` boolean — If the appointment is finished or not
  - `deleteFlag` boolean — If the appointment is deleted or not
  - `overdue` boolean — If the appointment is overdue or not
  - `finishTime` integer — The finish time of the task
  - `leadId` integer — The lead(Id) associated with the appointment
  - `assignToUid` integer — The user's Id of the appointment assigned to
  - `assignRoleType` integer — The user role of the appointment assigned to
  - `creatorId` integer — The user ID of this appointment creator

## Other responses

- `400` — Caller has no access to the lead (20017 PERMISSION_DENIED).
- `401` — Missing or invalid authentication token.
- `404` — Lead does not exist (20006 LEAD_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/versions/23e640467118/schema)