Get Buses Endpoint

Retrieves all buses available for either a route(Lagos->Abuja), the schedule(the day the user wants to travel), etc. It can also be customized to filter out exact information using path parameters.

Fetch Buses Based on Schedule (Pass the schedule ID as a path parameter)

get

This endpoint allows users to search for available buses based on a schedule. We plan to make it possible to also get buses based on the Route ID in the nearest future.

Path parameters

schedule_idintegerOptional

Filter buses by a specific schedule ID (departure time).

Responses

200

List of buses based on a schedule.

application/json

successbooleanOptional

Indicates whether the request was successful.

Example: true

statusintegerOptional

HTTP status code representing the response status.

Example: 200

messagestringOptional

Human-readable description of the response.

Example: List of buses based on a schedule

400

Bad request due to invalid input

application/json

500

Internal server error

application/json

get

/api/v1/merpi/transport/buses/{schedule_id}

HTTPcURLJavaScriptPython

GET /api/v1/merpi/transport/buses/{schedule_id} HTTP/1.1
Accept: */*

{
  "success": true,
  "status": 200,
  "message": "List of buses based on a schedule",
  "data": {
    "buses": [
      {
        "id": 5,
        "name": "Haice 2",
        "image": "storage/…/…/….jpg",
        "seats": 16,
        "price": "0"
      },
      {
        "id": 4,
        "name": "Haice bus",
        "image": ".../…/…/….jpg",
        "seats": 20,
        "price": "0"
      }
    ],
    "next_page": null,
    "count": 2,
    "per_page": 20
  }
}