# List appointments

List appointments on the caller's calendar.

Returns appointments on the caller's calendar. The caller is the signed-in person, or the person an agent credential acts for. There is no address parameter.

A canceled row stays in the list. A guest's row omits the organizer's notes.

## Authentication

`Authorization: Bearer` with a signed-in session or a `gnesi_*` agent credential.

## Query parameters

`from` and `to` are ISO 8601 instants. The list is appointments whose time overlaps that window.

## Response

`appointments` is a list. Each item includes `id`, `title`, `startsAt`, `endsAt`, `status`, and `organizer`. The organizer's row also includes `notes` and `guests`.

```sample
curl "https://api.gnesi.io/v1/appointments?from=2026-10-20T00:00:00.000Z&to=2026-10-27T00:00:00.000Z" \
  -H "Authorization: Bearer $GNESI_CREDENTIAL"
```

```result
{
  "appointments": [
    {
      "id": "appointment_123",
      "title": "Intro",
      "startsAt": "2026-10-20T15:00:00.000Z",
      "endsAt": "2026-10-20T15:30:00.000Z",
      "notes": "Bring the brief.",
      "status": "confirmed",
      "organizer": "ada@gnesi.io",
      "guests": ["mina@gnesi.io"]
    }
  ]
}
```