---
title: "What is coming up"
method: GET
path: "/api/upcoming"
tags: ["Organise"]
---

# What is coming up

`GET /api/upcoming`

## Request

- Base URL: `https://trvlrr.app`
- URL: `https://trvlrr.app/api/upcoming`
- Auth: HTTP bearer

The next trip, and every departure, check-in, check-out and activity in the next days (default 30, at most 90) in time order — one schedule for reminders and widgets.

## Query parameters

- `days` integer, nullable: How far ahead, 1–90 (default 30).

## Response `200`

The schedule.

- Upcoming
  - `next_trip` object, nullable, required
    - `id` string, required
    - `title` string, required
    - `start_date` string, required
    - `end_date` string, nullable, required
    - `days_away` integer, required
  - `items` UpcomingItem[], required
    - `id` string, required
    - `kind` 'transport' | 'checkin' | 'checkout' | 'activity', required
    - `trip_id` string, required
    - `trip_title` string, required
    - `title` string, required
    - `subtitle` string, nullable, required
    - `date` string, required
    - `time` string, required
    - `icon` string, nullable, required
    - `depart_tz` string, nullable, required
    - `arrive_tz` string, nullable, required
    - `depart_utc` string, nullable, required
    - `arrive_utc` string, nullable, required
    - `from_code` string, nullable, required
    - `to_code` string, nullable, required
    - `operating_carrier` string, nullable, required
    - `aircraft` string, nullable, required
    - `cabin` string, nullable, required
    - `seats` string, nullable, required
    - `depart_terminal` string, nullable, required
    - `arrive_terminal` string, nullable, required
    - `ticket_numbers` string, nullable, required
    - `agency` string, nullable, required
    - `tz` string, nullable, required
    - `check_in_utc` string, nullable, required
    - `check_out_utc` string, nullable, required
    - `address` string, nullable, required
    - `room_type` string, nullable, required
    - `guests` integer, nullable, required
    - `at_utc` string, nullable, required
  - `reminders` object[]: Notes, activities and checklist items with a reminder date in the next 60 days, not done.
    - `id` string, required
    - `kind` 'activity' | 'checklist', required
    - `trip_id` string, required
    - `trip_title` string, required
    - `title` string, required
    - `note` string, nullable, required
    - `remind_on` string, required: Date, YYYY-MM-DD.
    - `remind_time` string, nullable: "HH:MM"; empty means 09:00.

## Other responses

- `401`: No usable credential: a Clerk session token, a device token or an OAuth access token is required.

---

[API](https://skmtc.dev/trvlrr/apis/trvlrr-api.md) · [All operations](https://skmtc.dev/trvlrr/apis/trvlrr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trvlrr/apis/trvlrr-api/revisions/ea024946b293?raw)