Create a new institution

POST

/api/v1/institutions

Create a new institution with location details and optional image.
Requires authentication. Use multipart/form-data when uploading an image.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params multipart/form-dataRequired

Responses

🟢201

application/json

Institution created successfully

Bodyapplication/json

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/institutions' \
--header 'Authorization: Bearer <token>' \
--form 'institution[name]="Rumah Sakit Umum Jakarta"' \
--form 'institution[province]="DKI Jakarta"' \
--form 'institution[city]="Jakarta Pusat"' \
--form 'institution[district]="Menteng"' \
--form 'institution[subdistrict]="Menteng"' \
--form 'institution[address]="Jl. Diponegoro No. 78"' \
--form 'institution[postcode]="10310"' \
--form 'institution[latitude]="-6.1944"' \
--form 'institution[longitude]="106.8529"' \
--form 'institution[image]=@""'

Response Example

201 - Success

{
    "success": true,
    "data": {
        "institution": {
            "id": 3,
            "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-13T10:00:00Z",
            "updated_at": "2025-12-13T10:00:00Z"
        }
    }
}

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

Search institutions by name

Search institutions by location