Get all Cities Endpoint

Retrieves the list of cities that Syticks supports. Eg Iyana Ipaja, Festac, Kubwa etc.

Fetch All Cities

get

This endpoint returns the list of cities and their corresponding states in Nigeria that Syticks supports.

Query parameters

searchstringOptional

Filter cities based on a search parameter. For example, if you pass "La" as the search term, it will return all cities that contain "La".

per_pageinteger · int32Optional

Specifies the number of cities per page. For example, if per_page is set to 10, the response will contain 10 cities.

Responses

200

Successful retrieval of cities.

application/json

successbooleanOptional

Indicates if the request was successful.

statusintegerOptional

HTTP status code (200 indicates success).

messagestringOptional

Human-readable description of the response.

400

Bad Request - Invalid input or query parameters.

application/json

500

Internal Server Error

application/json

get

/api/v1/merpi/transport/cities

HTTPcURLJavaScriptPython

GET /api/v1/merpi/transport/cities HTTP/1.1
Accept: */*

{
  "success": true,
  "status": 200,
  "message": "List of cities",
  "data": {
    "cities": [
      {
        "id": 1,
        "name": "Awka",
        "state": {
          "id": 4,
          "name": "Anambra"
        }
      },
      {
        "id": 2,
        "name": "Ekwulobia",
        "state": {
          "id": 4,
          "name": "Anambra"
        }
      },
      {
        "id": 3,
        "name": "Lekki",
        "state": {
          "id": 24,
          "name": "Lagos"
        }
      },
      {
        "id": 4,
        "name": "Iyanya",
        "state": {
          "id": 37,
          "name": "Federal Capital Territory"
        }
      },
      {
        "id": 5,
        "name": "9th Mile",
        "state": {
          "id": 14,
          "name": "Enugu"
        }
      },
      {
        "id": 6,
        "name": "Nnewi",
        "state": {
          "id": 4,
          "name": "Anambra"
        }
      },
      {
        "id": 7,
        "name": "Onitsha",
        "state": {
          "id": 4,
          "name": "Anambra"
        }
      },
      {
        "id": 8,
        "name": "Iyana-Ipaja",
        "state": {
          "id": 24,
          "name": "Lagos"
        }
      }
    ],
    "next_page": null,
    "count": 8,
    "per_page": 20
  }
}