Get Schedules Endpoint

Retrieves the schedules of a route, based on the day the user selects that they want to travel. It can also be customized to filter out exact information using query parameters.

A schedule is usually based on when your customer wants to travel. So, if your customer selects that they want to travel on the 26th of November, they'll get all available schedules within a 7-day period. That means that if, 27th is also available, that schedule will be returned alongside the departure and arrival time.

And if 26th is not available, other days within the same 7-day period that are available are returned.

Please, make sure to pass the route_id and the day your customer selects that they want to travel.

Fetch Schedules Based on Route, Terminal, and Date

get

This endpoint fetches a list of available schedules for a specific route, terminal, and date. Users can see the schedules for their selected day and also receive schedules for the next 7 days for more options.

Query parameters

route_idintegerRequired

This is the ID of the route (Lagos -> Abuja).

terminal_idintegerRequired

This is the ID of the terminal.

datestringRequired

This is the day that the user wants to travel (e.g., '25-08-2024'). The response includes schedules within a 7-day period.

Responses

200

List of bus schedules.

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 bus schedules

get

/api/v1/merpi/transport/schedules

HTTPcURLJavaScriptPython

GET /api/v1/merpi/transport/schedules?route_id=1&terminal_id=1&date=text HTTP/1.1
Accept: */*

200

List of bus schedules.

{
  "success": true,
  "status": 200,
  "message": "List of bus schedules",
  "data": {
    "schedules": [
      {
        "id": 2,
        "name": "Early Bird",
        "from": "Awka",
        "to": "Lekki",
        "slug": null,
        "time": {
          "departure": "12:00 PM",
          "arrival": "03:00 AM"
        },
        "days": {
          "monday": 0,
          "tuesday": 1,
          "wednesday": 1,
          "thursday": 1,
          "friday": 0,
          "saturday": 1,
          "sunday": 1
        },
        "price_breakdown": {
          "ticket_price": 540,
          "convenience_fee": 10.8,
          "merchant_commission": 16.2
        },
        "route": {
          "id": 11,
          "price": 567,
          "schedule_type": "timed",
          "from": {
            "address": "698 Rocky Brook Cv, Cordova, TN 38018",
            "city": {
              "id": 1,
              "name": "Awka",
              "state": {
                "id": 4,
                "name": "Anambra"
              }
            }
          },
          "to": {
            "address": "17th Ave Abuja Awka State",
            "city": {
              "id": 3,
              "name": "Lekki",
              "state": {
                "id": 24,
                "name": "Lagos"
              }
            }
          }
        },
        "terminal": {
          "id": 7,
          "name": "Terminal One",
          "address": "698 Rocky Brook Cv, Cordova, TN 38018",
          "location": "Anambra",
          "slug": "terminal-one"
        },
        "business": {
          "id": "6e9d9432-2a1d-4a8a-a5e4-3ddfaf832523",
          "name": "User One",
          "photo": "https://dev.syticks.com/storage/profilePhotos/qOeJ9GsAEhTuCu7xaCNXMgzLyJtKhLgGxQwSuy7U.jpg",
          "slug": "user-one",
          "type": "bus"
        }
      },
      {
        "id": 16,
        "name": "",
        "from": "Nnewi",
        "to": "Awka",
        "slug": null,
        "time": {
          "departure": null,
          "arrival": null
        },
        "days": {
          "monday": 0,
          "tuesday": 1,
          "wednesday": 1,
          "thursday": 1,
          "friday": 1,
          "saturday": 1,
          "sunday": 1
        },
        "price_breakdown": {
          "ticket_price": 100,
          "convenience_fee": 2,
          "merchant_commission": 3
        },
        "route": {
          "id": 27,
          "price": 105,
          "schedule_type": "random",
          "from": {
            "address": null,
            "city": {
              "id": 6,
              "name": "Nnewi",
              "state": {
                "id": 4,
                "name": "Anambra"
              }
            }
          },
          "to": {
            "address": null,
            "city": {
              "id": 1,
              "name": "Awka",
              "state": {
                "id": 4,
                "name": "Anambra"
              }
            }
          }
        },
        "terminal": {
          "id": 10,
          "name": "Eastern Mass Terminal",
          "address": "No 3 Igwe Orizu Road, Roundabout, Nnewi",
          "location": "Anambra",
          "slug": "eastern-mass-terminal"
        },
        "business": {
          "id": "7daeb476-3e90-419d-8c6f-4bcd50e1eb03",
          "name": "God is Good",
          "photo": "https://dev.syticks.com/storage/profilePhotos/qr3JZSnpxxxNKQ7mbaBS0P00qejPzxXp7tQ8rgtM.jpg",
          "slug": "god-is-good",
          "type": "bus"
        }
      }
    ],
    "next_page": "2",
    "count": 64,
    "per_page": 20
  }
}