TItimeless
meetings

List upcoming meetings

Changed on

Returns a paginated list of upcoming meetings from the authenticated user's connected calendar, ordered by start time. These are scheduled calendar events that have not yet started — distinct from the recorded meetings returned by GET /meetings.

get/meetings/upcoming

Request

  • Base URL
    https://api.timeless.day/v1
  • URL
    https://api.timeless.day/v1/meetings/upcoming
  • Auth
    HTTP bearer

Query parameters

within_hoursinteger nullable

Only return events starting within this many hours from now (1–8760). Omit for no upper bound.

cursorstring nullable

Pagination cursor from a previous response's next_cursor.

limitinteger

Number of results per page (1–100).

Response

A paginated list of upcoming meetings.

next_cursorstring nullable required

Cursor for the next page. null if no more results.

has_moreboolean required

Whether more results exist beyond this page.

Example response

{
  "data": [
    {
      "id": "evt_abc123",
      "title": "Product roadmap review",
      "start_time": "2025-01-20T15:00:00Z",
      "end_time": "2025-01-20T16:00:00Z",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "participants": [
        {
          "name": "Bob Smith",
          "email": "bob@example.com",
          "response_status": "accepted"
        }
      ],
      "organizer": {
        "name": "Bob Smith",
        "email": "bob@example.com",
        "response_status": "accepted"
      },
      "created_at": "2025-01-15T09:30:00Z"
    }
  ]
}

Changes