Skip to main content

Overview

The Trips API allows you to manage travel trips in the MayTravel platform. Each trip includes details such as title, shelter location (stored as geographic coordinates), arrival and departure dates, and associated stops.

Available Endpoints

Get All Trips

Retrieve all trips in the system

Get Trip by ID

Retrieve a specific trip with its stops

Create Trip

Create a new trip for a user

Delete Trip

Delete an existing trip

Get User Trips

Get all trips for a specific user

Trip Object

A trip object contains the following fields:
  • id - Unique identifier for the trip
  • user_id - ID of the user who owns the trip
  • title - Title/name of the trip
  • shelter - Geographic point (POINT type) representing the shelter location
  • arrive_date - Arrival date for the trip
  • leave_date - Departure date for the trip
  • stops - Array of stops associated with the trip (when retrieved by ID)

Base URL

All API requests should be made to:
https://api.maytravel.com

Build docs developers (and LLMs) love