List appointments

List appointments on the caller's calendar.

GET https://api.gnesi.io/v1/appointments

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.

GET

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"

Example

{
  "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"]
    }
  ]
}