# Itinera API ## Docs - [✈ Itinera API Documentation](https://itinera.apidog.io/-itinera-api-documentation-2345670m0.md): - Docs > legacy [Itinera — System Overview](https://itinera.apidog.io/itinera-system-overview-2353703m0.md): - Docs > legacy [Technology Stack & Architecture](https://itinera.apidog.io/technology-stack-amp-architecture-2353704m0.md): - Docs > legacy [Getting Started Guide](https://itinera.apidog.io/getting-started-guide-2353701m0.md): - Docs > legacy [Infrastructure](https://itinera.apidog.io/infrastructure-2353702m0.md): - Docs > legacy [Frontend Application](https://itinera.apidog.io/frontend-application-2353700m0.md): - Docs > legacy [Architecture Overview](https://itinera.apidog.io/architecture-overview-2353697m0.md): - Docs > legacy [API Reference](https://itinera.apidog.io/api-reference-2353696m0.md): - Docs > legacy [Backend Services](https://itinera.apidog.io/backend-services-2353698m0.md): - Docs > legacy [Development Guidelines](https://itinera.apidog.io/development-guidelines-2353699m0.md): - Docs > phases [01. Architecture Overview & Checkout Idempotency](https://itinera.apidog.io/01-architecture-overview-amp-checkout-idempotency-2353705m0.md): - Docs > phases [Phase 2: Commerce & Checkout Engine](https://itinera.apidog.io/phase-2-commerce-amp-checkout-engine-2353706m0.md): - Docs > phases [Phase 3: Webhooks & Asynchronous Fulfillment](https://itinera.apidog.io/phase-3-webhooks-amp-asynchronous-fulfillment-2353707m0.md): - Docs > phases [Phase 4: Security Perimeter & Authentication](https://itinera.apidog.io/phase-4-security-perimeter-amp-authentication-2353708m0.md): - Docs > phases [Phase 5: Database Schema & Entity Relationships](https://itinera.apidog.io/phase-5-database-schema-amp-entity-relationships-2353709m0.md): - Docs > phases [Phase 6: AI Quota & Telemetry Subsystems](https://itinera.apidog.io/phase-6-ai-quota-amp-telemetry-subsystems-2353710m0.md): - Docs > phases [Phase 7: API Route Matrix & FormRequests](https://itinera.apidog.io/phase-7-api-route-matrix-amp-formrequests-2353711m0.md): - Docs > phases [Phase 8: Global Exception & Error Handling](https://itinera.apidog.io/phase-8-global-exception-amp-error-handling-2353712m0.md): - Docs > phases [Phase 9: Frontend Ecosystem & State Management](https://itinera.apidog.io/phase-9-frontend-ecosystem-amp-state-management-2353713m0.md): - Docs > phases [Phase 10: Design System & Component Library](https://itinera.apidog.io/phase-10-design-system-amp-component-library-2353714m0.md): - Docs > phases [Phase 11: Interactive GSAP Animations](https://itinera.apidog.io/phase-11-interactive-gsap-animations-2353715m0.md): - Docs > phases [Phase 12: Deployment & CI/CD Pipeline](https://itinera.apidog.io/phase-12-deployment-amp-cicd-pipeline-2353716m0.md): - Docs > phases [Phase 13: Testing Strategies](https://itinera.apidog.io/phase-13-testing-strategies-2353717m0.md): - Docs > phases [Phase 14: Performance & Optimization](https://itinera.apidog.io/phase-14-performance-amp-optimization-2353718m0.md): - Docs > phases [Phase 15: Developer Onboarding & Runbooks](https://itinera.apidog.io/phase-15-developer-onboarding-amp-runbooks-2353719m0.md): - Docs > phases [15-Phase Comprehensive Wiki & Documentation Plan](https://itinera.apidog.io/15-phase-comprehensive-wiki-amp-documentation-plan-2353720m0.md): ## API Docs - APIs > Auth [Register a new user](https://itinera.apidog.io/register-a-new-user-42232497e0.md): - APIs > Auth [Log in a user](https://itinera.apidog.io/log-in-a-user-42232498e0.md): - APIs > Auth [Log out user](https://itinera.apidog.io/log-out-user-42232499e0.md): - APIs > Auth [Refresh JWT token](https://itinera.apidog.io/refresh-jwt-token-42232500e0.md): - APIs > Auth [Forgot password request](https://itinera.apidog.io/forgot-password-request-42232501e0.md): - APIs > Auth [Reset password verification](https://itinera.apidog.io/reset-password-verification-42232502e0.md): - APIs > Auth [Get current user profile](https://itinera.apidog.io/get-current-user-profile-42232503e0.md): - APIs > Auth [Update user profile](https://itinera.apidog.io/update-user-profile-42232504e0.md): - APIs > Auth [Redirect to Google OAuth](https://itinera.apidog.io/redirect-to-google-oauth-42232505e0.md): - APIs > Auth [Google OAuth Callback](https://itinera.apidog.io/google-oauth-callback-42232506e0.md): - APIs > Auth [Verify email via signed URL](https://itinera.apidog.io/verify-email-via-signed-url-42232507e0.md): - APIs > Catalog [List all countries](https://itinera.apidog.io/list-all-countries-42232508e0.md): - APIs > Catalog [Get country details](https://itinera.apidog.io/get-country-details-42232509e0.md): - APIs > Catalog [List all cities](https://itinera.apidog.io/list-all-cities-42232510e0.md): - APIs > Catalog [List all regions](https://itinera.apidog.io/list-all-regions-42232511e0.md): - APIs > Catalog [List all destinations](https://itinera.apidog.io/list-all-destinations-42232512e0.md): - APIs > Catalog [Get destination details](https://itinera.apidog.io/get-destination-details-42232513e0.md): - APIs > Catalog [Get hotels by destination](https://itinera.apidog.io/get-hotels-by-destination-42232514e0.md): - APIs > Catalog [List all hotels](https://itinera.apidog.io/list-all-hotels-42232515e0.md): - APIs > Catalog [Get hotel details](https://itinera.apidog.io/get-hotel-details-42232516e0.md): - APIs > Catalog [Get reviews for a hotel](https://itinera.apidog.io/get-reviews-for-a-hotel-42232517e0.md): - APIs > Catalog [List all flights](https://itinera.apidog.io/list-all-flights-42232518e0.md): - APIs > Catalog [Get flight details](https://itinera.apidog.io/get-flight-details-42232519e0.md): - APIs > Catalog [List all restaurants](https://itinera.apidog.io/list-all-restaurants-42232520e0.md): - APIs > Catalog [Get restaurant details](https://itinera.apidog.io/get-restaurant-details-42232521e0.md): - APIs > Catalog [List all attractions](https://itinera.apidog.io/list-all-attractions-42232522e0.md): - APIs > Catalog [Get current weather](https://itinera.apidog.io/get-current-weather-42232523e0.md): - APIs > Catalog [Submit review for an entity](https://itinera.apidog.io/submit-review-for-an-entity-42232524e0.md): - APIs > Catalog [Delete review](https://itinera.apidog.io/delete-review-42232525e0.md): - APIs > Catalog [Toggle favourite status for entity](https://itinera.apidog.io/toggle-favourite-status-for-entity-42232526e0.md): - APIs > Catalog [List my submitted reviews](https://itinera.apidog.io/list-my-submitted-reviews-42232527e0.md): - APIs > Bookings [Book a tour destination](https://itinera.apidog.io/book-a-tour-destination-42232528e0.md): - APIs > V1 Aliases [V1 List all countries](https://itinera.apidog.io/v1-list-all-countries-42232529e0.md): - APIs > V1 Aliases [V1 Get country details](https://itinera.apidog.io/v1-get-country-details-42232530e0.md): - APIs > V1 Aliases [V1 List all cities](https://itinera.apidog.io/v1-list-all-cities-42232531e0.md): - APIs > V1 Aliases [V1 List all destinations](https://itinera.apidog.io/v1-list-all-destinations-42232532e0.md): - APIs > V1 Aliases [V1 Get destination details](https://itinera.apidog.io/v1-get-destination-details-42232533e0.md): - APIs > V1 Aliases [V1 Get hotels by destination](https://itinera.apidog.io/v1-get-hotels-by-destination-42232534e0.md): - APIs > V1 Aliases [V1 List all hotels](https://itinera.apidog.io/v1-list-all-hotels-42232535e0.md): - APIs > V1 Aliases [V1 Get hotel details](https://itinera.apidog.io/v1-get-hotel-details-42232536e0.md): - APIs > V1 Aliases [V1 Get reviews for a hotel](https://itinera.apidog.io/v1-get-reviews-for-a-hotel-42232537e0.md): - APIs > V1 Aliases [V1 List all flights](https://itinera.apidog.io/v1-list-all-flights-42232538e0.md): - APIs > V1 Aliases [V1 Get flight details](https://itinera.apidog.io/v1-get-flight-details-42232539e0.md): - APIs > V1 Aliases [V1 List all restaurants](https://itinera.apidog.io/v1-list-all-restaurants-42232540e0.md): - APIs > V1 Aliases [V1 Get restaurant details](https://itinera.apidog.io/v1-get-restaurant-details-42232541e0.md): - APIs > V1 Aliases [V1 List all attractions](https://itinera.apidog.io/v1-list-all-attractions-42232542e0.md): - APIs > V1 Aliases [V1 Get attraction details](https://itinera.apidog.io/v1-get-attraction-details-42232543e0.md): - APIs > V1 Aliases [V1 List all regions](https://itinera.apidog.io/v1-list-all-regions-42232544e0.md): - APIs > V1 Aliases [V1 Get weather details](https://itinera.apidog.io/v1-get-weather-details-42232545e0.md): - APIs > Trips [List user trips](https://itinera.apidog.io/list-user-trips-42232546e0.md): - APIs > Trips [Create a new trip](https://itinera.apidog.io/create-a-new-trip-42232547e0.md): - APIs > Trips [Get trip details](https://itinera.apidog.io/get-trip-details-42232548e0.md): - APIs > Trips [Update trip details](https://itinera.apidog.io/update-trip-details-42232549e0.md): - APIs > Trips [Delete a trip](https://itinera.apidog.io/delete-a-trip-42232550e0.md): - APIs > Trips [Get creation metadata](https://itinera.apidog.io/get-creation-metadata-42232551e0.md): - APIs > Trips [Attach items to a trip](https://itinera.apidog.io/attach-items-to-a-trip-42232552e0.md): - APIs > Trips [Update trip item](https://itinera.apidog.io/update-trip-item-42232553e0.md): - APIs > Trips [Detach items from a trip](https://itinera.apidog.io/detach-items-from-a-trip-42232554e0.md): - APIs > Trips [Fork a trip](https://itinera.apidog.io/fork-a-trip-42232555e0.md): - APIs > Conversations [List user conversations](https://itinera.apidog.io/list-user-conversations-42232556e0.md): - APIs > Conversations [Start a new conversation](https://itinera.apidog.io/start-a-new-conversation-42232557e0.md): - APIs > Conversations [Get conversation details](https://itinera.apidog.io/get-conversation-details-42232558e0.md): - APIs > Conversations [List messages in conversation](https://itinera.apidog.io/list-messages-in-conversation-42232559e0.md): - APIs > Conversations [Send message to conversation](https://itinera.apidog.io/send-message-to-conversation-42232560e0.md): - APIs > Conversations [Mark conversation as read](https://itinera.apidog.io/mark-conversation-as-read-42232561e0.md): - APIs > Commerce Plans [List public plans](https://itinera.apidog.io/list-public-plans-42232562e0.md): - APIs > Commerce Plans [Get public plan details](https://itinera.apidog.io/get-public-plan-details-42232563e0.md): - APIs > Commerce Subscriptions [Subscribe to a plan](https://itinera.apidog.io/subscribe-to-a-plan-42232564e0.md): - APIs > Commerce Subscriptions [Upgrade active plan](https://itinera.apidog.io/upgrade-active-plan-42232565e0.md): - APIs > Commerce Subscriptions [Get active subscription info](https://itinera.apidog.io/get-active-subscription-info-42232566e0.md): - APIs > Commerce Subscriptions [Cancel active subscription](https://itinera.apidog.io/cancel-active-subscription-42232567e0.md): - APIs > Commerce Checkout [Initiate Paymob payment checkout](https://itinera.apidog.io/initiate-paymob-payment-checkout-42232568e0.md): - APIs > Integrations [Paymob status webhook callback](https://itinera.apidog.io/paymob-status-webhook-callback-42232569e0.md): - APIs > Integrations [Paymob redirect return callback](https://itinera.apidog.io/paymob-redirect-return-callback-42232570e0.md): - APIs > System Settings & Support [Submit public contact message](https://itinera.apidog.io/submit-public-contact-message-42232571e0.md): - APIs > System Settings & Support [Subscribe to system newsletter](https://itinera.apidog.io/subscribe-to-system-newsletter-42232572e0.md): - APIs > System Settings & Support [Get list of my reports](https://itinera.apidog.io/get-list-of-my-reports-42232573e0.md): - APIs > System Settings & Support [List all notifications](https://itinera.apidog.io/list-all-notifications-42232574e0.md): - APIs > System Settings & Support [Mark single notification as read](https://itinera.apidog.io/mark-single-notification-as-read-42232575e0.md): - APIs > System Settings & Support [List available surveys](https://itinera.apidog.io/list-available-surveys-42232576e0.md): - APIs > System Settings & Support [Submit answers for survey](https://itinera.apidog.io/submit-answers-for-survey-42232577e0.md): - APIs > System Settings & Support [Get survey details](https://itinera.apidog.io/get-survey-details-42232578e0.md): - APIs > System Settings & Support [Update survey details](https://itinera.apidog.io/update-survey-details-42232579e0.md): - APIs > System Settings & Support [Delete survey response](https://itinera.apidog.io/delete-survey-response-42232580e0.md): - APIs > AI Tools [Enhance itinerary details using AI](https://itinera.apidog.io/enhance-itinerary-details-using-ai-42232581e0.md): - APIs > AI Tools [Request AI review of itinerary](https://itinera.apidog.io/request-ai-review-of-itinerary-42232582e0.md): - APIs > AI Tools [Plan route using AI assistance](https://itinera.apidog.io/plan-route-using-ai-assistance-42232583e0.md): - APIs > AI Tools [Get AI quota remaining details](https://itinera.apidog.io/get-ai-quota-remaining-details-42232584e0.md): - APIs > AI Tools [Chat with AI Concierge assistant](https://itinera.apidog.io/chat-with-ai-concierge-assistant-42232585e0.md): - APIs > AI Tools [Get AI Review progress by ID](https://itinera.apidog.io/get-ai-review-progress-by-id-42232586e0.md): - APIs > Agency Integration [Request agency assignment](https://itinera.apidog.io/request-agency-assignment-42232587e0.md): - APIs > Agency Integration [List agency active tasks](https://itinera.apidog.io/list-agency-active-tasks-42232588e0.md): - APIs > Agency Integration [List agency managed trips](https://itinera.apidog.io/list-agency-managed-trips-42232589e0.md): - APIs > Agency Integration [Get agency total earnings](https://itinera.apidog.io/get-agency-total-earnings-42232590e0.md): - APIs > Agency Integration [Get agency profile details](https://itinera.apidog.io/get-agency-profile-details-42232591e0.md): - APIs > Agency Integration [Update agency profile details](https://itinera.apidog.io/update-agency-profile-details-42232592e0.md): - APIs > Admin User Management [List users inside admin dashboard](https://itinera.apidog.io/list-users-inside-admin-dashboard-42232593e0.md): - APIs > Admin User Management [Get user profile](https://itinera.apidog.io/get-user-profile-42232594e0.md): - APIs > Admin User Management [Set user active status](https://itinera.apidog.io/set-user-active-status-42232595e0.md): - APIs > Admin User Management [Block user profile](https://itinera.apidog.io/block-user-profile-42232596e0.md): - APIs > Admin Catalog Moderation [Create new catalog category](https://itinera.apidog.io/create-new-catalog-category-42232597e0.md): - APIs > Admin Catalog Moderation [Create new catalog destination](https://itinera.apidog.io/create-new-catalog-destination-42232598e0.md): - APIs > Admin Catalog Moderation [Create new hotel catalog record](https://itinera.apidog.io/create-new-hotel-catalog-record-42232599e0.md): - APIs > Admin Catalog Moderation [Create new flight catalog record](https://itinera.apidog.io/create-new-flight-catalog-record-42232600e0.md): - APIs > Admin Catalog Moderation [Create new restaurant catalog record](https://itinera.apidog.io/create-new-restaurant-catalog-record-42232601e0.md): - APIs > Admin Catalog Moderation [Create new attraction catalog record](https://itinera.apidog.io/create-new-attraction-catalog-record-42232602e0.md): ## Schemas - [User](https://itinera.apidog.io/user-17219276d0.md): - [ErrorResponse](https://itinera.apidog.io/errorresponse-17219277d0.md): - [Trip](https://itinera.apidog.io/trip-17219278d0.md): - [Destination](https://itinera.apidog.io/destination-17219279d0.md): - [Hotel](https://itinera.apidog.io/hotel-17219280d0.md): - [Flight](https://itinera.apidog.io/flight-17219281d0.md): - [Restaurant](https://itinera.apidog.io/restaurant-17219282d0.md): - [Attraction](https://itinera.apidog.io/attraction-17219283d0.md): - [Booking](https://itinera.apidog.io/booking-17219284d0.md): - [Review](https://itinera.apidog.io/review-17219285d0.md): - [Agency](https://itinera.apidog.io/agency-17219286d0.md): - [Survey](https://itinera.apidog.io/survey-17219287d0.md):