Itineraries (v2)

Poll the build

The progress of the latest build (or the one named by buildId): status, days completed, the days streamed since sinceDay, the legs of a multi-city build, and terminal once it is completed, partial or failed. Only the build's owner may poll it.

get/api/v2/itineraries/{externalId}/build

Request

Base URL: https://www.endlesstravelplans.com
URL: https://www.endlesstravelplans.com/api/v2/itineraries/{externalId}/build
Auth: HTTP bearer

Query parameters

buildIdstring

A particular build; the latest when left out.

Example:b1

sinceDayinteger

Days already received; only the later ones are sent.

Example:2

Response

build_idstring

statusstring

days_completedinteger

total_daysinteger

progressinteger

streamed_days_offsetinteger

terminalboolean

Example response

{
  "build_id": "b1",
  "status": "streaming",
  "days_completed": 2,
  "total_days": 5,
  "progress": 40,
  "streamed_days": [
    {
      "date": "2026-11-12",
      "title": "Old town",
      "day_number": 3,
      "activities": [
        {
          "id": "ai_5f0c2d9e",
          "name": "Belem Tower",
          "time": "9:00 AM",
          "end_time": "10:30 AM",
          "duration": "1.5 hours",
          "duration_minutes": 90,
          "category": "culture",
          "rating": 4.6,
          "image": null,
          "image_search": "Belem Tower Lisbon",
          "tip": "Go early to beat the queue.",
          "price": 12,
          "price_source": "suggested",
          "source": "ai_generated",
          "is_custom": false,
          "coordinates": {
            "lat": 38.6916,
            "lng": -9.216
          },
          "latitude": 38.6916,
          "longitude": -9.216,
          "photo_url": "https://lh3.googleusercontent.com/p/belem.jpg",
          "opening_hours": null,
          "google_rating": 4.6,
          "address": "Av. Brasilia, 1400-038 Lisboa",
          "place_id": "ChIJ8a5S4vLKGQ0R"
        }
      ]
    }
  ],
  "streamed_days_offset": 2,
  "terminal": false
}

Changes

No recorded changes to this operation across all 1 revision of this API.