Trips API¶
Endpoint¶
GET https://api.backend.traveln.ai/v1/trips/{uuid}/
Retrieve a single trip by its unique identifier.
Authentication: Authorization: Api-Key <partner_key>
Path parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
uuid | string | Yes | Trip identifier |
Example requests¶
curl "https://api.backend.traveln.ai/v1/trips/UUID_VALUE/" \
-H "Authorization: Api-Key <partner_key>"
const res = await fetch("https://api.backend.traveln.ai/v1/trips/UUID_VALUE/", {
headers: { Authorization: "Api-Key <partner_key>" },
})
const data = await res.json()
import requests
res = requests.get(
"https://api.backend.traveln.ai/v1/trips/UUID_VALUE/",
headers={"Authorization": "Api-Key <partner_key>"},
)
data = res.json()
Example response¶
{
"id": "da97442d-209e-48f0-ad31-a96d31932c39",
"countries": [
{
"id": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9",
"created_at": "2022-04-07T15:53:43Z",
"updated_at": "2024-12-27T13:36:10Z",
"code": "ae",
"name": "United Arab Emirates",
"phone_code": "+971",
"supported": true,
"flag": "https://s3.me-south-1.amazonaws.com/traveln.media.data/countries-flag/dummy_data/flags/ae.png",
"cities": [
{
"id": "de59cb1a-092f-4c03-ab75-43c63d247a38",
"created_at": "2022-10-08T08:45:11Z",
"updated_at": "2025-01-10T09:12:54Z",
"name": "Dubai",
"coordinates": {
"type": "Point",
"coordinates": [
55.2707828,
25.2048493
]
},
"capital": "admin",
"image_uri": "cities/UAE/Dubai",
"images": [
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai1.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai2.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai3.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai4.jpg"
],
"alternative_names": [],
"matched_cities": [],
"country": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9"
}
]
}
],
"start_date": "2026-06-03T00:00:00Z",
"end_date": "2026-06-05T23:59:59Z",
"days": 3,
"nights": 2,
"saved_by_me": false,
"dates": [
{
"date": "2026-06-05",
"description": "Experience the thrill of hot air ballooning, camel rides, and jet skiing, followed by a scenic dhow cruise with dinner in the vibrant city of Dubai.",
"attractions": [
{
"attraction": {
"id": "523c9270-cebb-44bf-9849-faf6f321443a",
"name": "Kite and Surf Beach",
"description": "A popular destination for kiteboarding and surfing enthusiasts, offering great waves and a vibrant beach culture.",
"address": "Kite and Surf Beach - 57 57 Al Hadd St - Jumeirah - Jumeirah 3 - Dubai - United Arab Emirates",
"significant": 4.638825460026202,
"coordinates": {
"type": "Point",
"coordinates": [
55.2202899,
25.1784836
]
},
"distance": null,
"multi_coordinates": {
"type": "MultiPoint",
"coordinates": [
[
55.2202899,
25.1784836
]
]
},
"rating": 4.5,
"total_num_of_rating": 1171.0,
"source": "GOOGLE",
"status": "PENDING",
"recommended_by_experts": [],
"city": {
"id": "de59cb1a-092f-4c03-ab75-43c63d247a38",
"name": "Dubai",
"images": [
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai1.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai2.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai3.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai4.jpg"
],
"country": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9",
"coordinates": {
"type": "Point",
"coordinates": [
55.2707828,
25.2048493
]
}
},
"country": {
"id": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9",
"name": "United Arab Emirates",
"code": "ae",
"phone_code": "+971",
"flag": "https://s3.me-south-1.amazonaws.com/traveln.media.data/countries-flag/dummy_data/flags/ae.png"
},
"medias": [
{
"file_type": "image/jpeg",
"file": "https://s3.me-south-1.amazonaws.com/traveln.media.data/AE/Dubai/ChIJDfdhywZqXz4Rtq-HD4zbSyA/faa97928-e0e7-4d0e-aadc-8e80156e654c.jpg"
}
],
"classes": [
{
"id": "209bf83b-876b-4426-949b-08b4b016e46f",
"created_at": "2022-03-17T10:09:54Z",
"updated_at": "2025-04-28T09:23:04Z",
"name": "Ecofriendly",
"label": "ECOFRIENDLY",
"challenge_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Eco_friendly.png",
"type": null,
"categories": [
"safari",
"botanical_gardens",
"zoos",
"campground",
"eco_tours",
"beaches",
"bird_watching",
"aquariums",
"national_parks"
],
"challenge_default_url": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Eco_friendly.png",
"attraction_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/attraction_default/Eco_Friendly_PA9h4Nn.png",
"image": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/images/Eco_Friendly_VgOxQz8.png",
"icon": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/Eco_Friendly_White.png"
}
],
"saved_by_me": false,
"type": "POI",
"categories": [
"beaches",
"surfing"
]
},
"from_time": "18:00:00",
"to_time": "21:00:00",
"duration_time": "0:15:00"
}
]
}
],
"is_booked_by_me": false,
"booking_status": null,
"accommodation": {
"id": "1f7a0408-25be-4cfa-a59f-b826257d0e2f",
"type": "ACCOMMODATION",
"distance": null,
"schedule": null,
"saved_by_me": null,
"snippets": [],
"trips": [],
"rooms": [
{
"room_code": "STU.ST-1",
"is_parent_room": false,
"min_pax": 1,
"max_pax": 2,
"room_stays": [
{
"number": 1,
"stayType": "BED",
"description": "King-size bed 150-183 width"
}
],
"max_adults": 2,
"max_children": 1,
"min_adults": 1,
"description": "STUDIO STANDARD",
"images": [
{
"path": "10/1004956/1004956a_hb_ro_047.jpg",
"source": "HotelBeds",
"caption": "Room"
}
]
},
{
"room_code": "DBT.B1-CV",
"is_parent_room": false,
"min_pax": 1,
"max_pax": 6,
"room_stays": [],
"max_adults": 6,
"max_children": 3,
"min_adults": 1,
"description": "Double or Twin CITY VIEW ONE BEDROOM",
"images": []
}
],
"created_at": "2025-04-18T04:14:31Z",
"updated_at": "2025-09-18T13:55:12Z",
"name": "Damac Maison Aykon City Dubai",
"automated": false,
"description": "Rising along Sheikh Zayed Road, overlooking Dubai Canal, AYKON City Hotel Apartments opens your world to luxury living in one of the most prestigious neighborhoods in Dubai. Be neighbors with landmarks and global luxury brands through a collection of luxury serviced hotel apartments, complemented by world-class leisure experiences strung together at the podium level of AYKON City. ",
"address": "395 Sheikh Zayed Rd",
"coordinates": {
"type": "Point",
"coordinates": [
55.2524261,
25.1801681
]
},
"multi_coordinates": {
"type": "MultiPoint",
"coordinates": [
[
55.2524261,
25.1801681
]
]
},
"website": "https://www.damachotelsandresorts.com/en/damac-maison-coming-soon/",
"phone": null,
"strip_product_id": null,
"status": "APPROVED",
"visibility_status": "PRIVATE",
"rating": 0.0,
"total_num_of_rating": 0.0,
"significant": 0.0,
"categories": [
"hotels"
],
"tags": [
"luxurious",
"scenic_views",
"modern_design"
],
"source": "HOTELBEDS",
"other_includes": [],
"zipcode": "1111",
"accommodation_code": "1004956",
"category": "5 STARS",
"category_group": "Includes 5-star hotel and 5 star luxury.",
"chain": "Damac Hotels & Resorts Management LLC",
"accommodation_type": "APARTHOTEL",
"number_rooms": 175,
"number_floors": 132,
"checkin_time": null,
"checkout_time": null,
"images": [
{
"path": "10/1004956/1004956a_hb_f_008.jpg?20241001103434?20250610150310",
"source": "HotelBeds",
"caption": "Sports and Entertainment"
}
],
"facilities": [
{
"indFee": false,
"content": "aparthotel",
"indLogic": true
},
{
"indFee": false,
"content": "American Express",
"indLogic": true
}
],
"boards": [
"BED AND BREAKFAST",
"ROOM ONLY"
],
"segments": [
"Luxury collection"
],
"giatacode": null,
"phones": [
{
"phoneType": "PHONEBOOKING",
"phoneNumber": "+9714444111"
},
{
"phoneType": "PHONEHOTEL",
"phoneNumber": "+9714444111"
},
{
"phoneType": "FAXNUMBER",
"phoneNumber": "+001234567"
}
],
"health_safety_rating": "1*",
"internal_ranking": 60,
"cluster": "07f9a2f6-447b-4e43-b425-79b43be68ce3",
"profile": null,
"vendor": null,
"city": {
"id": "de59cb1a-092f-4c03-ab75-43c63d247a38",
"created_at": "2022-10-08T08:45:11Z",
"updated_at": "2025-01-10T09:12:54Z",
"name": "Dubai",
"coordinates": {
"type": "Point",
"coordinates": [
55.2707828,
25.2048493
]
},
"capital": "admin",
"image_uri": "cities/UAE/Dubai",
"images": [
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai1.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai2.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai3.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai4.jpg"
],
"alternative_names": [],
"matched_cities": [],
"country": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9"
},
"country": {
"id": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9",
"created_at": "2022-04-07T15:53:43Z",
"updated_at": "2024-12-27T13:36:10Z",
"code": "ae",
"name": "United Arab Emirates",
"phone_code": "+971",
"supported": true,
"mapbox_poi_layer_id": "trav-pois",
"mapbox_eoi_layer_id": "trav-eois",
"mapbox_aoi_layer_id": "trav-aois",
"flag": "https://s3.me-south-1.amazonaws.com/traveln.media.data/countries-flag/dummy_data/flags/ae.png"
},
"processing_log": "f9d88f35-8403-4c01-943a-b9bd6a0e025d",
"classes": [
{
"id": "80a1b968-4c03-4aef-a6de-e0a66e5e1b0c",
"created_at": "2024-02-22T00:33:42Z",
"updated_at": "2025-04-28T09:25:14Z",
"name": "Accommodation",
"label": "ACCOMMODATION",
"challenge_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Accomodations.png",
"type": null,
"categories": [
"heritage_stays",
"eco_lodges",
"hotels",
"luxury_resorts"
],
"challenge_default_url": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Accomodations.png",
"attraction_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/attraction_default/Accomodations_Uf9oZc1j.png",
"image": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/images/Accomodations_Rv7p2Xq.png",
"icon": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/accomodation_White.png"
}
],
"subscribers": [],
"likers": [],
"savers": [],
"recommended_by_experts": [],
"medias": [],
"reviews": []
},
"chat_id": "72a4ad21-9235-42e2-8038-db21d177d5ee",
"type": "DOMESTIC",
"privacy": "PRIVATE",
"adults": 1,
"children": 0,
"pets": 0,
"title": "Entertainment Extravaganza in Dubai",
"cover_photo": null,
"description": "This exciting trip to Dubai promises a perfect blend of adventure and romance for couples seeking entertainment. Discover the thrill of dune bashing in the Arabian desert during the Dune Buggy Dubai experience, followed by an unforgettable evening on the Dubai Romantic Dhow Creek Dinner Cruise, complete with live shows and an international buffet. Enjoy a relaxing boat tour aboard a luxury yacht, soaking in stunning views of the city's skyline. For a delightful twist, glide around the Dubai Ice Rink for some fun on ice, and elevate your adventure with a Premium Hot Air Balloon experience that includes a breathtaking sunrise, camel rides, and a chance to quench your thirst for excitement on a quad bike. This trip is designed to create memorable moments and joyful experiences in the heart of Dubai.",
"generated_by_ai": true,
"others": "",
"profile": {
"id": "1ed4a350-f5d0-49c9-8ce2-2cb572a75f8t",
"username": "user@traveln.ai",
"first_name": "User",
"last_name": "User",
"current_level": {
"id": 1,
"level": 1,
"xp_required": 1000
},
"business_name": null,
"profile_picture": null
},
"classes": [
{
"id": "0de1fe24-5793-4aff-8046-f897ac8bf348",
"created_at": "2022-03-17T10:09:54Z",
"updated_at": "2025-04-28T09:22:28Z",
"name": "Adventure and Amusement",
"label": "AMUSEMENT",
"challenge_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Entertainment.png",
"type": null,
"categories": [
"amusement_park",
"gaming_centers",
"theme_parks",
"interactive_museums",
"adventure_parks",
"escape_rooms",
"indoor_play_centers",
"water_parks",
"vr_ar_experiences"
],
"challenge_default_url": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/challenge_default/Entertainment.png",
"attraction_default": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/attraction_default/Entertainment_BzAuacq.png",
"image": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/images/Entertainment_oHXGT9I.png",
"icon": "https://s3.me-south-1.amazonaws.com/traveln.media.data/classes/adventure_White.png"
}
],
"cities": [
{
"id": "de59cb1a-092f-4c03-ab75-43c63d247a38",
"created_at": "2022-10-08T08:45:11Z",
"updated_at": "2025-01-10T09:12:54Z",
"name": "Dubai",
"coordinates": {
"type": "Point",
"coordinates": [
55.2707828,
25.2048493
]
},
"capital": "admin",
"image_uri": "cities/UAE/Dubai",
"images": [
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai1.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai2.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai3.jpg",
"https://s3.me-south-1.amazonaws.com/traveln.media.data/cities/UAE/Dubai/Dubai4.jpg"
],
"alternative_names": [],
"matched_cities": [],
"country": "c3e7bb7a-2a01-4281-b9fa-b4c48032fce9"
}
],
"medias": [],
"subscribers": [],
"likers": [],
"savers": []
}
Error responses¶
401 Unauthorized: missing/invalidApi-Key.403 Forbidden: key lacks permission to access tenant.404 Not Found: trip not found.500 Server Error: unexpected error.