API Hasil Ujian - CBT Indolat

Seluruh request pada halaman ini membutuhkan Bearer API Key. Satu hasil ujian mewakili satu tes milik satu peserta. Data hasil dibuat saat peserta didaftarkan ke ujian, lalu diperbarui saat peserta mengerjakan tes dan saat nilainya dihitung. Hasil milik peserta yang sudah dihapus dari projek tidak ditampilkan.

Kapan nilai tersedia

score bernilai null sampai nilai tes dihitung. Waktu perhitungannya bergantung pada metode penilaian tes:

Metode penilaian	Kapan `score` terisi
Perhitungan Skor Soal (Akumulasi Benar/Salah)	Otomatis saat peserta selesai mengerjakan tes.
Perhitungan Skor Jawaban (Akumulasi Skor Jawaban)	Otomatis saat peserta selesai mengerjakan tes.
Psikotes (Pengelompokan Jawaban)	Otomatis saat peserta selesai. `score` selalu `0`; hasil per kelompok jawaban tidak tersedia melalui API.
IRT (Referensi UTBK 0-1000, TKA SMA/SMK 200-800, TKA SD/SMP 0-100)	Setelah admin menjalankan Hitung Skor → Perhitungan IRT pada panel. Sebelum itu `score` bernilai `null`.
Penilaian Manual	Setelah admin menilai jawaban peserta pada panel.

Nilai dapat berubah setelah pertama kali terbit, misalnya saat admin menjalankan ulang Perhitungan IRT atau perhitungan ulang skor. Setiap perubahan memperbarui updated_at dan mengirim webhook exam_result.scored. Gunakan updated_since untuk menyinkronkan ulang hasil yang berubah.

Struktur `meta_score`

meta_score bernilai null sebelum nilai pertama kali dihitung. Isinya bergantung pada metode penilaian:

Metode penilaian	Isi `meta_score`
Akumulasi Benar/Salah	`correct`, `incorrect`, `unanswered` (jumlah soal).
Akumulasi Skor Jawaban	`correct`, `incorrect`, `unanswered`, dan `answer_scores` berupa objek `{ "<id soal>": skor }`.
Psikotes	`total_answered`, `total_unanswered`.
IRT	`correct`, `incorrect`, `unanswered`, `irt_theta` (kemampuan peserta), `irt_scale` (skala yang dipakai: `irt`, `irt_tka_sma`, atau `irt_tka_sd_smp`), dan `difficulty_map` berupa objek `{ "<id soal>": tingkat kesulitan }`.

Endpoint hasil ujian

GET /exam-results — Daftar hasil ujian

Data diurutkan dari hasil terbaru.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`exam_id`	Query	Tidak	integer	Filter ID ujian.
`participant_id`	Query	Tidak	integer	Filter ID peserta.
`email`	Query	Tidak	email	Filter email peserta secara persis.
`exam_quiz_id`	Query	Tidak	integer	Filter ID tes.
`status`	Query	Tidak	integer	`0` pending, `1` aktif (belum atau sedang dikerjakan), `2` selesai, `3` ditolak.
`min_score`	Query	Tidak	numeric	Nilai minimum.
`max_score`	Query	Tidak	numeric	Nilai maksimum.
`finished_from`	Query	Tidak	datetime	Waktu selesai minimum dalam ISO 8601 dan harus di-URL-encode.
`finished_until`	Query	Tidak	datetime	Waktu selesai maksimum dalam ISO 8601 dan harus di-URL-encode.
`updated_since`	Query	Tidak	datetime	Hanya hasil yang berubah sejak waktu ini; ISO 8601 dan harus di-URL-encode.
`page`	Query	Tidak	integer	Nomor halaman. Default `1`.
`per_page`	Query	Tidak	integer	Data per halaman, `1–100`. Default `25`.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exam-results?exam_id=12&status=2&min_score=70&page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "id": 9812,
      "uuid": "9f1c2a2d-9739-4c2f-9a94-312a9cc1b4ad",
      "user_exam_id": 4410,
      "exam_quiz_id": 45,
      "exam_quiz_name": "Tes Potensi Akademik",
      "status": 2,
      "status_label": "Selesai Ujian",
      "score": 82.5,
      "meta_score": { "correct": 33, "incorrect": 7, "unanswered": 0 },
      "session": {
        "id": 91,
        "exam_quiz_id": 45,
        "name": "Sesi Pagi",
        "start_at": "2026-08-10T08:00:00+07:00",
        "end_at": "2026-08-10T10:00:00+07:00"
      },
      "start_at": "2026-08-10T08:05:00+07:00",
      "end_at": "2026-08-10T09:20:00+07:00",
      "duration_seconds": 4500,
      "participant_code": "TPA0000021",
      "participant": {
        "id": 340,
        "name": "Budi Santoso",
        "email": "budi@sekolah.sch.id",
        "is_active": true,
        "is_verified": true,
        "verified_at": "2026-07-30T09:00:00+07:00",
        "created_at": "2026-07-30T09:00:00+07:00",
        "updated_at": "2026-07-30T09:00:00+07:00"
      },
      "exam": {
        "id": 12,
        "name": "Tes Masuk 2026",
        "name_short": "TPA",
        "slug": "tes-masuk-2026",
        "description": "Seleksi penerimaan peserta didik baru.",
        "price": 0,
        "start_at": "2026-08-10T08:00:00+07:00",
        "end_at": "2026-08-10T12:00:00+07:00",
        "is_active": true,
        "is_locked": false,
        "is_hidden": false,
        "is_tiered": false,
        "is_auto_assign_session": true,
        "is_show_score": true,
        "final_score_type": 2,
        "final_score_type_label": "Rata-Rata Tes Ujian",
        "paid_type": 1,
        "paid_type_label": "Gratis",
        "registration_quota": 500,
        "created_at": "2026-07-01T08:00:00+07:00",
        "updated_at": "2026-07-30T08:00:00+07:00"
      },
      "created_at": "2026-07-30T10:00:00+07:00",
      "updated_at": "2026-08-10T09:20:00+07:00"
    }
  ],
  "meta": {
    "pagination": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1, "from": 1, "to": 1 }
  }
}

GET /exam-results/{id} — Detail hasil ujian

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`id`	Path	Ya	integer	ID hasil ujian.

Contoh request

curl -X GET "https://app.indolat.com/api/v1/exam-results/9813" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

Contoh berikut adalah tes dengan penilaian IRT yang nilainya sudah dihitung. Objek exam dipersingkat; isinya sama dengan contoh pada daftar hasil ujian.

{
  "success": true,
  "message": null,
  "data": {
    "id": 9813,
    "uuid": "3b7e5d10-1c2f-4a8e-b0e4-6a2f1d9c7e21",
    "user_exam_id": 4410,
    "exam_quiz_id": 46,
    "exam_quiz_name": "Penalaran Umum",
    "status": 2,
    "status_label": "Selesai Ujian",
    "score": 642,
    "meta_score": {
      "correct": 22,
      "incorrect": 6,
      "unanswered": 2,
      "irt_theta": 1.1368,
      "irt_scale": "irt",
      "difficulty_map": { "1201": -0.8473, "1202": 0.4055, "1203": 1.3863 }
    },
    "session": {
      "id": 92,
      "exam_quiz_id": 46,
      "name": "Sesi Pagi",
      "start_at": "2026-08-10T08:00:00+07:00",
      "end_at": "2026-08-10T10:00:00+07:00"
    },
    "start_at": "2026-08-10T09:25:00+07:00",
    "end_at": "2026-08-10T09:55:00+07:00",
    "duration_seconds": 1800,
    "participant_code": "TPA0000021",
    "participant": {
      "id": 340,
      "name": "Budi Santoso",
      "email": "budi@sekolah.sch.id",
      "is_active": true,
      "is_verified": true,
      "verified_at": "2026-07-30T09:00:00+07:00",
      "created_at": "2026-07-30T09:00:00+07:00",
      "updated_at": "2026-07-30T09:00:00+07:00"
    },
    "exam": {
      "id": 12,
      "name": "Tes Masuk 2026",
      "name_short": "TPA",
      "slug": "tes-masuk-2026"
    },
    "created_at": "2026-07-30T10:00:00+07:00",
    "updated_at": "2026-08-11T08:00:00+07:00"
  }
}

​Kapan nilai tersedia

​Struktur meta_score

​Endpoint hasil ujian

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

Kapan nilai tersedia

Struktur `meta_score`

Endpoint hasil ujian

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response