Read an itinerary
The document for the caller: the inputs, the plan with its days, suggested pool, markers and budget, the latest build, the share state and what the caller may do. The owner, an accepted collaborator and, while the row is shared by link, any signed-in caller may read it; a private row answers 404. state is draft (no plan yet), generating (a build is running; build carries it), ready or finished. An activity is the generator's entry plus the Places fields (coordinates to place_id) once enrichment found the place; a suggested pool entry is the generator's entry alone. A marker carries id, category and order once an edit has recomputed the markers; a plan straight from a build has lat, lng, name and day only.
Request
- Base URL: https://www.endlesstravelplans.com
- URL: https://www.endlesstravelplans.com/api/v2/itineraries/{externalId}
- Auth: HTTP bearer
Response
Example response
{
"external_id": "9c7e",
"state": "ready",
"plan": {
"days": [
{
"date": "2026-11-10",
"day_number": 1,
"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"
}
]
}
],
"suggested_pool": [
{
"id": "ai_7d21b0aa",
"name": "Feira da Ladra",
"time": "10:00 AM",
"end_time": "12:00 PM",
"duration": "2 hours",
"duration_minutes": 120,
"category": "shopping",
"rating": 4.3,
"image": null,
"image_search": "Feira da Ladra Lisbon flea market",
"tip": "Tuesdays and Saturdays only.",
"price": 0,
"price_source": null,
"source": "ai_generated",
"is_custom": false
}
],
"markers": [
{
"id": "ai_5f0c2d9e",
"name": "Belem Tower",
"lat": 38.6916,
"lng": -9.216,
"category": "culture",
"day": 1,
"order": 1
}
],
"budget": {
"spent": 0,
"total": 0,
"remaining": 0,
"currency": "USD"
}
},
"can": {
"edit": true,
"share": true,
"export": true,
"generate": true,
"finish": true
},
"edit_version": 3
}Changes
No recorded changes to this operation across all 1 revision of this API.