Get Bus Seats Endpoint

Retrieves the bus seats available based on the bus, and the schedule(schedule_id) and the date the customer wishes to travel.

Ideally, this endpoint will be called after customer has selected the type of bus, the schedule(6AM bus, 8AM bus, etc) and the date that he or she wishes to travel. This end point returns the bus and it's seating arrangement data which you can use to model the bus' seating arrangement so your customers can select their preferred seat as if they were seeing the bus in reality.

Get Bus Seats

get

Retrieve the seat availability for a specific bus and schedule on a given date. It returns the seats and signifies which seats are taken and which seats are available.

Path parameters

schedule_idintegerRequired

This is the ID of the schedule.

bus_idintegerRequired

This is the ID of the bus.

departure_datestring · dateOptional

The day that the user wants to travel.

Responses

200

Bus Seat Grid showing available bus seats

application/json

successbooleanOptional

statusintegerOptional

messagestringOptional

get

/api/v1/merpi/transport/bus/seats/{schedule_id}/{bus_id}/{departure_date}

HTTPcURLJavaScriptPython

GET /api/v1/merpi/transport/bus/seats/{schedule_id}/{bus_id}/{departure_date} HTTP/1.1
Accept: */*

200

Bus Seat Grid showing available bus seats

{
  "success": true,
  "status": 200,
  "message": "Bus Seat Grid showing available bus seats",
  "data": {
    "seats": [
      [
        {
          "id": 1,
          "seat": false,
          "row": 1,
          "column": 1,
          "available": false
        },
        {
          "id": 2,
          "seat": false,
          "row": 1,
          "column": 2,
          "available": false
        },
        {
          "id": 3,
          "seat": true,
          "row": 1,
          "column": 3,
          "available": true
        }
      ],
      [
        {
          "id": 4,
          "seat": true,
          "row": 2,
          "column": 1,
          "available": true
        },
        {
          "id": 5,
          "seat": false,
          "row": 2,
          "column": 2,
          "available": false
        },
        {
          "id": 6,
          "seat": true,
          "row": 2,
          "column": 3,
          "available": true
        }
      ],
      [
        {
          "id": 7,
          "seat": true,
          "row": 3,
          "column": 1,
          "available": true
        },
        {
          "id": 8,
          "seat": true,
          "row": 3,
          "column": 2,
          "available": true
        },
        {
          "id": 9,
          "seat": true,
          "row": 3,
          "column": 3,
          "available": true
        }
      ],
      [
        {
          "id": 10,
          "seat": true,
          "row": 4,
          "column": 1,
          "available": true
        },
        {
          "id": 11,
          "seat": true,
          "row": 4,
          "column": 2,
          "available": true
        },
        {
          "id": 12,
          "seat": true,
          "row": 4,
          "column": 3,
          "available": true
        }
      ]
    ],
    "bus": {
      "id": 1,
      "name": "Haice bus",
      "image": "storage/…/…/….jpg",
      "seats": 20,
      "price": "0",
      "rows": 4,
      "columns": 3,
      "seat_grid": [
        [
          {
            "id": 1,
            "seat": false,
            "row": 1,
            "column": 1
          },
          {
            "id": 2,
            "seat": false,
            "row": 1,
            "column": 2
          },
          {
            "id": 3,
            "seat": true,
            "row": 1,
            "column": 3
          }
        ],
        [
          {
            "id": 4,
            "seat": true,
            "row": 2,
            "column": 1
          },
          {
            "id": 5,
            "seat": false,
            "row": 2,
            "column": 2
          },
          {
            "id": 6,
            "seat": true,
            "row": 2,
            "column": 3
          }
        ],
        [
          {
            "id": 7,
            "seat": true,
            "row": 3,
            "column": 1
          },
          {
            "id": 8,
            "seat": true,
            "row": 3,
            "column": 2
          },
          {
            "id": 9,
            "seat": true,
            "row": 3,
            "column": 3
          }
        ],
        [
          {
            "id": 10,
            "seat": true,
            "row": 4,
            "column": 1
          },
          {
            "id": 11,
            "seat": true,
            "row": 4,
            "column": 2
          },
          {
            "id": 12,
            "seat": true,
            "row": 4,
            "column": 3
          }
        ]
      ]
    },
    "schedule": {
      "id": 5,
      "name": "Schedule One",
      "time": {
        "departure": "10:00 AM",
        "arrival": "10:00 AM"
      },
      "days": {
        "monday": 1,
        "tuesday": 1,
        "wednesday": 1,
        "thursday": 1,
        "friday": 1,
        "saturday": 1,
        "sunday": 1
      },
      "route": {
        "id": 10,
        "price": 2500,
        "from": {
          "address": "Unizk Junction, TempSite Awka, Anambra",
          "city": {
            "id": 2,
            "name": "Ekwulobia",
            "state": {
              "id": 4,
              "name": "Anambra"
            }
          }
        },
        "to": {
          "address": "Mikin Hill, Oba, Enugu",
          "city": {
            "id": 4,
            "name": "Iyanya",
            "state": {
              "id": 37,
              "name": "Federal Capital Territory"
            }
          }
        }
      },
      "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://syticks.com/…/…/….jpg",
        "slug": "user-one",
        "type": "bus"
      }
    }
  }
}