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
  }
}

Fetch Buses Based on Route, Schedule, or Transport Company

get

This endpoint allows users to search for available buses based on route, schedule, or transport company using query parameters. This endpoint offers flexibility for users to find available buses based on their travel plans. Filtering by route, schedule, or transport company allows for targeted searches.

Query parameters

route_idintegerOptional

Filter buses by a specific route ID.

schedule_idintegerOptional

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

transport_idintegerOptional

Filter buses by a specific transport company ID.

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.

500

Server error.

get

/api/v1/transport/buses

HTTPcURLJavaScriptPython

GET /api/v1/transport/buses 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
  }
}