Search institutions by name

GET

/api/v1/institutions

Search and list institutions with optional name filter.
Results are paginated and can be sorted.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200

application/json

Institutions retrieved successfully

Bodyapplication/json

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/institutions?page=undefined&per_page=undefined&sort_by=undefined&sort_order=undefined&q=Rumah%20Sakit&province=DKI%20Jakarta&city=Jakarta%20Selatan' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Successful search with results

{
    "success": true,
    "data": [
        {
            "id": 1,
            "name": "Rumah Sakit Pusat Jakarta",
            "province": "DKI Jakarta",
            "city": "Jakarta Selatan",
            "subdistrict": "Kebayoran Baru",
            "address": "Jl. Sudirman No. 123",
            "latitude": -6.2088,
            "longitude": 106.8456,
            "created_at": "2025-12-01T10:00:00Z",
            "updated_at": "2025-12-07T11:30:00Z"
        },
        {
            "id": 2,
            "name": "Rumah Sakit Umum Jakarta",
            "province": "DKI Jakarta",
            "city": "Jakarta Pusat",
            "subdistrict": "Menteng",
            "address": "Jl. Diponegoro No. 78",
            "latitude": -6.1944,
            "longitude": 106.8529,
            "created_at": "2025-12-02T09:00:00Z",
            "updated_at": "2025-12-06T14:20:00Z"
        }
    ],
    "meta": {
        "page": 1,
        "per_page": 20,
        "total_count": 45,
        "total_pages": 3,
        "prev_page": null,
        "next_page": 2
    }
}

Modified at 2026-06-08 00:59:16

Get current user info

Create a new institution