Create a Student

Developing

POST

/students

To create a new Student.

A Student will be created using the provided information. The response body will contain a JSON object with a key called result. The value will be an object containing the standard attributes for your new Student. The response code will be 201 if the User was successfully created.

Request

Body Params application/json

Example

{
    "userId": "1fb16bbf0fdfeff0d47583fb",
    "nisn": "0011730411",
    "nipd": "12345",
    "nik": "9777544030416000",
    "skhun": "IX-A-12345-2021-123",
    "birthCertificateNumber": "3578-LU-28112012-0018",
    "familyCardNumber": "1758537299693582",
    "father": {
        "name": "Rini Rini Mulyani",
        "nik": "0360245706925767",
        "birthPlace": "Anyer",
        "birthDate": "2025-10-24T03:03:43.153Z",
        "education": "S1",
        "phoneNumber": "6281234567890",
        "occupation": "National Security Consultant",
        "income": "Lebih dari Rp. 20,000,000",
        "specialNeeds": [
            "RUNGU"
        ]
    },
    "mother": null,
    "guardian": null,
    "residenceType": "ASRAMA",
    "transportationMode": "MOBIL PRIBADI",
    "height": 155,
    "weight": 38,
    "headCircumference": 58,
    "distance": 57072,
    "travelTime": 3,
    "siblings": 0,
    "numberOfSiblings": 2,
    "phoneNumber": "6281234567890",
    "religion": null,
    "address": {
        "street": "Jl. Beruang",
        "rt": "072",
        "rw": "010",
        "subDistrict": "Sempaja Utara",
        "district": "Samarinda Utara",
        "city": "Samarinda",
        "province": "Kalimantan Timur",
        "country": "ID",
        "postalCode": "75124",
        "location": {
            "type": "POINT",
            "coordinates": [
                29,
                8
            ]
        }
    },
    "birthDate": "2025-10-24T03:03:43.168Z",
    "birthPlace": "Sumenep",
    "birthOrder": 1,
    "bloodType": "A",
    "gender": null,
    "landline": "0541123456",
    "specialNeeds": [
        "GRAHITA RINGAN",
        "GRAHITA RINGAN",
        "RUNGU"
    ],
    "hobby": "Membaca",
    "dream": "Pilot"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://sims.sman1samarinda.sch.id/api/students' \
--header 'Content-Type: application/json' \
--data-raw '{
    "userId": "1fb16bbf0fdfeff0d47583fb",
    "nisn": "0011730411",
    "nipd": "12345",
    "nik": "9777544030416000",
    "skhun": "IX-A-12345-2021-123",
    "birthCertificateNumber": "3578-LU-28112012-0018",
    "familyCardNumber": "1758537299693582",
    "father": {
        "name": "Rini Rini Mulyani",
        "nik": "0360245706925767",
        "birthPlace": "Anyer",
        "birthDate": "2025-10-24T03:03:43.153Z",
        "education": "S1",
        "phoneNumber": "6281234567890",
        "occupation": "National Security Consultant",
        "income": "Lebih dari Rp. 20,000,000",
        "specialNeeds": [
            "RUNGU"
        ]
    },
    "mother": null,
    "guardian": null,
    "residenceType": "ASRAMA",
    "transportationMode": "MOBIL PRIBADI",
    "height": 155,
    "weight": 38,
    "headCircumference": 58,
    "distance": 57072,
    "travelTime": 3,
    "siblings": 0,
    "numberOfSiblings": 2,
    "phoneNumber": "6281234567890",
    "religion": null,
    "address": {
        "street": "Jl. Beruang",
        "rt": "072",
        "rw": "010",
        "subDistrict": "Sempaja Utara",
        "district": "Samarinda Utara",
        "city": "Samarinda",
        "province": "Kalimantan Timur",
        "country": "ID",
        "postalCode": "75124",
        "location": {
            "type": "POINT",
            "coordinates": [
                29,
                8
            ]
        }
    },
    "birthDate": "2025-10-24T03:03:43.168Z",
    "birthPlace": "Sumenep",
    "birthOrder": 1,
    "bloodType": "A",
    "gender": null,
    "landline": "0541123456",
    "specialNeeds": [
        "GRAHITA RINGAN",
        "GRAHITA RINGAN",
        "RUNGU"
    ],
    "hobby": "Membaca",
    "dream": "Pilot"
}'

Responses

🟢201Created

application/json

Body

Example

{
    "success": true,
    "message": "OK.",
    "meta": {},
    "errors": [],
    "result": {
        "id": "6a7d876fe417272f3a53ab42",
        "nisn": "0011730411",
        "nipd": "12345",
        "nik": "0355516394848020",
        "skhun": "IX-A-12345-2021-123",
        "birthCertificateNumber": "3578-LU-28112012-0018",
        "familyCardNumber": "6501993515169715",
        "father": {
            "name": "Adiarja Adiarja Ramadan",
            "nik": "1943096399052940",
            "birthPlace": "Soreang",
            "birthDate": "2025-10-19T08:10:55.563Z",
            "education": "S1",
            "phoneNumber": "6281234567890",
            "occupation": "Future Markets Planner",
            "income": "Rp. 500,000 - Rp. 999,999",
            "specialNeeds": []
        },
        "mother": {
            "name": "Zahrah Melinda",
            "nik": "2855778469268253",
            "birthPlace": "Pacitan",
            "birthDate": "2025-10-19T08:10:55.563Z",
            "education": "S1",
            "phoneNumber": "6281234567890",
            "occupation": "Dynamic Data Architect",
            "income": "Kurang dari Rp. 500,000",
            "specialNeeds": [
                "NETRA"
            ]
        },
        "guardian": null,
        "residenceType": "ASRAMA",
        "transportationMode": "SEPEDA MOTOR",
        "height": 130,
        "weight": 95,
        "headCircumference": 57,
        "distance": 1377450178166930,
        "travelTime": 50,
        "siblings": "0",
        "numberOfSiblings": "2",
        "phoneNumber": "6281234567890",
        "religion": null,
        "address": {
            "street": "Jl. Beruang",
            "rt": "081",
            "rw": "051",
            "subDistrict": "Sempaja Utara",
            "district": "Samarinda Utara",
            "city": "Samarinda",
            "province": "Kalimantan Timur",
            "country": "ID",
            "postalCode": "75124",
            "location": {
                "type": "POINT",
                "coordinates": [
                    29753641.310860246,
                    -88244071.40114453
                ]
            }
        },
        "birthDate": "2025-10-19T08:10:55.566Z",
        "birthPlace": "Majene",
        "birthOrder": 1,
        "bloodType": "O",
        "gender": "MALE",
        "landline": "0541123456",
        "specialNeeds": [
            "NETRA",
            "GRAHITA RINGAN"
        ],
        "hobby": "Membaca",
        "name": "Fauzan"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠409Conflict

🔴500Server Error

Modified at 2026-01-01 23:23:58

Retrieve an Existing Student

Delete an Existing Student