1. Users
SIMSDIG
  • Academic Periods
    • Get All Academic Periods
      GET
    • Create a Academic Period
      POST
    • Retrieve an Existing Academic Period
      GET
    • Update an Existing Academic Period
      PATCH
    • Delete an Existing Academic Period
      DELETE
  • Attendance
    • Update Attendance Record as Admin
      PATCH
    • Get All Attendance Records
      GET
    • Bulk Upsert Attendance
      POST
    • Check In
      POST
    • Check Out
      POST
    • Run Attendance End-of-Day Cron
      GET
    • Export Attendance
      GET
    • Get Attendance History
      GET
    • Mark Attendance
      POST
    • Get Attendance Recap
      GET
    • Get Attendance Summary
      GET
    • Get Today's Attendance
      GET
    • Get Attendance Settings by User Type
      GET
  • Attendance Session
    • Create Attendance Session
    • Get Attendance Session
    • Update Attendance Session
    • Get Attendance Session QR
    • Get Attendance Session Records
    • Verify Attendance Session
  • Auth
    • Change Own Password
    • Get the Current Session
    • Request Password Reset
    • Reset Password
    • Sign In with Email and Password
    • Sign In with Social Provider
    • Sign Up with Email and Password
    • Sign Out the Current User
  • Calendar
    • Query Calendar Items
  • Calendar Feed
    • Get Personal Calendar Feed
    • Get Public iCal feed
    • Generate Calendar Feed Token
    • Revoke Calendar Feed Token
  • Class Subjects
    • Get All Class Subjects
    • Create a Class Subject
    • Retrieve an Existing Class Subject
    • Update an Existing Class Subject
    • Delete an Existing Class Subject
  • Classes
    • Get All Classes
    • Create a Class
    • Retrieve an Existing Class
    • Update Class
    • Delete an Existing Student Copy
    • Get Available Students
    • Assign Students To Class
    • Move Students
    • Unassign Students From Class
    • Batch Create Classes
    • Execute Promotion
    • Get Promotion Sources
  • Regions
    • List Countries
    • List Districts
    • List Provinces
    • List or Search Regencies
    • List Villages
  • Health
    • Health Check
  • Letters
    • Get All Letters
    • Create a Letter
    • Retrieve an Existing Letter
    • Initiate a Letter Action
    • List Current User Letter
    • List Recipients
    • List User Letter
  • Files
    • Create a Presigned URL
  • Roles
    • Get All Roles
    • Create a Role
    • Retrieve an Existing Role
    • Update an Existing Role
    • Delete an Existing Role
    • Get All Eligible Users for Role
    • Get All Members of Role
    • Add Bulk Member to Role
    • Remove Bulk Members from Role
  • Schedules
    • Get All Schedules
    • Create a Schedule
    • Retrieve an Existing Schedule
    • Update an Existing Schedule
    • Delete an Existing Schedule
  • School Calendar
    • Get All Calendar Events
    • Create a Calendar Event
    • Retrieve an Existing School Calendar
    • Update an Existing School Calendar
    • Delete an Existing School Calendar
  • Settings
    • Retrieve App Settings
    • Update App Settings
    • Get All Attendance Settings
    • Bulk Update Attendance Settings
    • Update Attendance Settings by User Type
    • Update Setting Key Value
    • Upload Background Image
    • Delete Login Background Image
    • Upload Logo Image
    • Delete Logo Image
    • Retrieve Public Settings
  • Time Slots
    • Get All Time Slots
    • Create a Time Slot
    • Retrieve an Existing Time Slot
    • Update an Existing Time Slot
    • Delete an Existing Time Slot
  • Staff
    • Get All Staff
    • Create a Staff
    • Retrieve an Existing Staff
    • Delete an Existing Staff
    • Update an Existing Staff
    • Export All Staff
    • Import Bulk Staffs
  • Users
    • Retrieve User Summary
      GET
    • Get All Users
      GET
    • Create a User
      POST
    • Retrieve an Existing User
      GET
    • Delete an Existing User
      DELETE
    • Update an Existing User
      PATCH
    • Update User Image
      POST
    • Get User Login History
      GET
    • Reset User Password
      PATCH
    • Get Current User
      GET
    • Update Current User
      PATCH
    • Update Own Profile Image
      POST
  • Statistics
    • Get All Stats
  • Students
    • Get All Students
    • Create a Student
    • Retrieve an Existing Student
    • Delete an Existing Student
    • Update an Existing Student
    • Export All Students
    • Import Bulk Students
  • Subjects
    • Get All Subjects
    • Create a Subject
    • Retrieve an Existing Subject
    • Update an Existing Subject
    • Delete an Existing Subject
  • Teachers
    • Get All Teachers
    • Create a Teacher
    • Retrieve an Existing Teacher
    • Delete an Existing Teacher
    • Update an Existing Teacher
    • Export All Teachers
    • Import Bulk Teachers
  • Schemas
    • AcademicPeriod
    • Actor
    • Address
    • AdminAttendanceRecord
    • AdminBulkUpsertRequest
    • AdminCorrectionRequest
    • AdminMarkRequest
    • AdminRecapItem
    • AgeStats
    • ApiError
    • AttendanceMethod
    • AttendanceRecord
    • AttendanceSession
    • AttendanceSetting
    • AttendanceStatus
    • AttendanceSummary
    • Base
    • bloodType
    • CalendarType
    • CalendarFeedToken
    • CalendarItem
    • CheckInRequest
    • CheckOutRequest
    • Class
    • ClassSubject
    • ClassStats
    • CountryItem
    • EconomyStats
    • EducationHistoryObject
    • EmploymentStats
    • Error
    • ErrorDetail
    • Gender
    • GenderStats
    • HealthStatus
    • HeightStats
    • ImageUploadResult
    • Letter
    • LetterHistory
    • LetterStatus
    • LetterType
    • Location
    • LoginHistory
    • Meta
    • ParentInfo
    • PublicSettings
    • RegionItem
    • Religion
    • ReligionDistribution
    • Roles
    • Schedule
    • SchoolCalendar
    • SettingKvUpdate
    • Staff
    • Student
    • Subjects
    • Teacher
    • TimeSlot
    • TodayAttendance
    • TransportationStats
    • User
    • UserProfile
    • VerifyAttendanceSessionRequest
    • VerifyAttendanceSessionResult
    • WeightStats
    • meta
    • error-detail
    • error
    • academic-period
    • attendance-status
    • admin-correction-request
    • attendance-method
    • attendance-record
    • admin-attendance-record
    • admin-bulk-upsert-request
    • check-in-request
    • check-out-request
    • admin-mark-request
    • admin-recap-item
    • attendance-session
    • verify-attendance-session-request
    • verify-attendance-session-result
    • attendance-summary
    • today-attendance
    • calendar-item
    • calendar-feed-token
    • class-subject
    • class
    • gender
    • country-item
    • region-item
    • health-status
    • actor
    • letter-type
    • letter-status
    • letter-history
    • letter
    • roles
    • schedule
    • calendar-type
    • school-calendar
    • attendance-setting
    • setting-kv-update
    • public-settings
    • time-slot
    • location
    • address
    • parent-info
    • blood-type
    • religion
    • staff
    • gender-stats
    • religion-distribution
    • weight-stats
    • height-stats
    • age-stats
    • transportation-stats
    • class-stats
    • economy-stats
    • employment-stats
    • subjects
    • teacher
    • student
    • user-profile
    • api-error
    • base
    • education-history-object
    • image-upload-result
    • login-history
    • user
  1. Users

Retrieve an Existing User

GET
/users/{userId}
Requires authenticated session. If the requested user matches the current session user, access is allowed; otherwise requires manage:user permission.

Request

Authorization
API Key
Add parameter in cookie
core.session_token
Example:
core.session_token: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Responses

🟢200
application/json
Body

🟠401unauthorized
🟠403forbidden
🟠404record-not-found
🔴500server-error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/users/'
Response Response Example
200 - Example 1
{
    "success": true,
    "message": "string",
    "meta": {
        "page": 0,
        "limit": 0,
        "total": 0
    },
    "errors": [
        {
            "code": "string",
            "field": "string",
            "message": "string"
        }
    ],
    "result": {
        "user": {
            "id": "string",
            "name": "string",
            "email": "string",
            "emailVerified": true,
            "secondaryEmail": "string",
            "image": "string",
            "active": true,
            "createdAt": "2019-08-24T14:15:22.123Z",
            "updatedAt": "2019-08-24T14:15:22.123Z"
        },
        "type": "STUDENT",
        "profile": {
            "id": "string",
            "userId": "string",
            "nisn": "string",
            "nipd": "string",
            "nik": "string",
            "skhun": "string",
            "birthCertificateNumber": "string",
            "familyCardNumber": "string",
            "father": {
                "name": "string",
                "nik": "string",
                "birthPlace": "string",
                "birthDate": "2019-08-24T14:15:22.123Z",
                "education": "NONE",
                "phone": "string",
                "occupation": "UNEMPLOYED",
                "income": "NO_INCOME",
                "specialNeeds": [
                    "VISUAL_IMPAIRMENT"
                ]
            },
            "mother": {
                "name": "string",
                "nik": "string",
                "birthPlace": "string",
                "birthDate": "2019-08-24T14:15:22.123Z",
                "education": "NONE",
                "phone": "string",
                "occupation": "UNEMPLOYED",
                "income": "NO_INCOME",
                "specialNeeds": [
                    "VISUAL_IMPAIRMENT"
                ]
            },
            "guardian": {
                "name": "string",
                "nik": "string",
                "birthPlace": "string",
                "birthDate": "2019-08-24T14:15:22.123Z",
                "education": "NONE",
                "phone": "string",
                "occupation": "UNEMPLOYED",
                "income": "NO_INCOME",
                "specialNeeds": [
                    "VISUAL_IMPAIRMENT"
                ]
            },
            "residenceType": "WITH_PARENTS",
            "transportationMode": "WALKING",
            "height": 0,
            "weight": 0,
            "headCircumference": 0,
            "distance": 0,
            "travelTime": 0,
            "siblings": 0,
            "numberOfSiblings": 0,
            "phone": "string",
            "religion": "ISLAM",
            "address": {
                "street": "string",
                "rt": "string",
                "rw": "string",
                "subDistrict": "string",
                "district": "string",
                "city": "string",
                "province": "string",
                "country": "string",
                "postalCode": "string",
                "location": {
                    "latitude": 0,
                    "longitude": 0
                }
            },
            "birthDate": "2019-08-24T14:15:22.123Z",
            "birthPlace": "string",
            "birthOrder": 0,
            "bloodType": "A",
            "gender": "MALE",
            "landline": "string",
            "hobby": "string",
            "dream": "string",
            "specialNeeds": [
                "VISUAL_IMPAIRMENT"
            ]
        },
        "roles": [
            {
                "id": "string",
                "name": "string",
                "icon": "string",
                "color": "string"
            }
        ]
    }
}
Modified at 2026-05-01 04:13:11
Previous
Create a User
Next
Delete an Existing User
Built with