> For the complete documentation index, see [llms.txt](https://syticks.gitbook.io/merpi-by-syticks/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://syticks.gitbook.io/merpi-by-syticks/api-reference/bus-ticketing-routes-terminals-schedules-buses-purchase-etc/get-schedules-endpoint-with-extra-information-deprecated-v1.md).
# Get Schedules Endpoint With Extra Information (DEPRECATED - V1)
### **Understanding Schedule Types**
Before using this endpoint, it's important to understand the two types of schedules in our transport system:
#### **Timed Schedules (Supported by This Endpoint)**
Fixed departure times that work perfectly for formal transport companies operating long-distance routes. For example:
* **GUO Transport (Lagos to Abuja):** 8-hour journey with strict 6 AM departure
* Passengers must arrive on time or miss the bus
* Creates predictability for business travelers and long-distance journeys
#### **Random Schedules (Not Supported by This Endpoint)**
Flexible timing for informal transport businesses operating shorter routes. For example:
* **Star Sunny Motors (Awka to Nnewi):** 1-hour journey with flexible timing
* Passengers can arrive throughout the day and find buses leaving soon
* Operates with time windows rather than fixed departure times
**Example of Random Schedule structure:**
* **Morning Operations (5 AM - 12 PM):** Shuttle buses (7 passengers) at ₦1,500 per person
* **Evening Operations (12 PM - 10 PM):** Hiace buses (14 passengers) at ₦1,200 per person
### **Endpoint Overview**
This V1 endpoint retrieves schedule information associated with a route (e.g., Lagos→Abuja) **for routes using Timed Schedules only**. It provides additional information compared to the original Get Schedules endpoint, including bus details, available seats, route information, terminal details, and business information.
#### **Key Features**
* Customizable query parameters to get exactly the information needed
* Returns schedule\_id and bus seat IDs for immediate ticket purchase
* Special note: **Always pass the departure date** to avoid requiring customers to change dates after purchase via email request
#### **Limitations**
* **Only works with Timed Schedules** - routes with fixed departure times
* Does not support Random Schedules with flexible timing windows
* For Random Schedule support, migrate to the V2 endpoint
### **Migrating to V2**
The **V2 endpoint** supports both Timed and Random schedules and should be used for all new integrations. The V2 endpoint provides:
* Full support for both schedule types (Timed and Random)
* Enhanced filtering capabilities
* Improved response structure
* Better performance and reliability
📘 **See V2 Documentation:** [Link to V2 endpoint documentation](/merpi-by-syticks/api-reference/bus-ticketing-routes-terminals-schedules-buses-purchase-etc/get-schedules-endpoint-with-extra-information-v2.md)
> Bear in mind that if you do not pass the departure date, the user will have to change the date and select a seat through the request change they will get in their mail after the ticket purchase. So, you are advised to always pass the departure date so your user does not have to take an extra step after purchase.
## Get bus schedules by route, departure and arrival city, terminal ID, business ID and departure date
> This endpoint retrieves available bus schedules based on the provided route ID, departure and arrival city ID, terminal ID, business ID and departure date.
```json
{"openapi":"3.0.3","info":{"title":"Syticks API","version":"1.0.0"},"paths":{"/api/v1/merpi/transport/schedules/packages":{"get":{"summary":"Get bus schedules by route, departure and arrival city, terminal ID, business ID and departure date","description":"This endpoint retrieves available bus schedules based on the provided route ID, departure and arrival city ID, terminal ID, business ID and departure date.\n","operationId":"getBusSchedulesByRouteAndDate","parameters":[{"name":"route_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID of the route to fetch schedules for."},{"name":"departure_date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Departure date for which to retrieve schedules (format YYYY-MM-DD)."},{"name":"from_city_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID of the city where the trip originates."},{"name":"to_city_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID of the destination city."},{"name":"business_id","in":"query","required":false,"schema":{"type":"string"},"description":"ID of the business offering the schedule (UUID format)."},{"name":"terminal_id","in":"query","required":false,"schema":{"type":"integer"},"description":"ID of the terminal associated with the departure."}],"responses":{"200":{"description":"List of bus schedules.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"status":{"type":"integer"},"message":{"type":"string"},"data":{"type":"object","properties":{"schedules":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"from":{"type":"string"},"to":{"type":"string"},"amount":{"type":"number","format":"float"},"time":{"type":"object","properties":{"departure":{"type":"string"},"arrival":{"type":"string"}}},"days":{"type":"object","properties":{"monday":{"type":"integer"},"tuesday":{"type":"integer"},"wednesday":{"type":"integer"},"thursday":{"type":"integer"},"friday":{"type":"integer"},"saturday":{"type":"integer"},"sunday":{"type":"integer"}}},"bus":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"image":{"type":"string"},"seats":{"type":"integer"},"price":{"type":"string"},"available_seats":{"type":"array","items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"seat":{"type":"boolean"},"row":{"type":"integer"},"column":{"type":"integer"},"available":{"type":"boolean"}}}}},"total_seats":{"type":"integer"}}},"route":{"type":"object","properties":{"id":{"type":"integer"},"price":{"type":"integer"},"from":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"state":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}},"to":{"type":"object","properties":{"address":{"type":"string"},"city":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"state":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}}}}}}},"terminal":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"address":{"type":"string"},"location":{"type":"string"},"slug":{"type":"string"}}},"business":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"photo":{"type":"string","format":"uri"},"slug":{"type":"string"},"type":{"type":"string"}}}}}},"next_page":{"type":"string","nullable":true},"count":{"type":"integer"},"per_page":{"type":"integer"}}}}}}}}}}}}}
```