API Peserta - CBT Indolat

Seluruh request pada halaman ini membutuhkan Bearer API Key.

Endpoint peserta

GET /participants — Daftar peserta

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`search`	Query	Tidak	string	Mencari nama atau email.
`email`	Query	Tidak	email	Mencocokkan email secara persis.
`label_id`	Query	Tidak	integer	Filter berdasarkan ID label.
`is_active`	Query	Tidak	boolean	Filter status aktif.
`is_verified`	Query	Tidak	boolean	Filter status verifikasi akun.
`sort_by`	Query	Tidak	enum	`name`, `created_at`, `updated_at`, atau `id`. Default `name`.
`sort_dir`	Query	Tidak	enum	`asc` atau `desc`. Default `asc`.
`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/participants?search=Budi&is_active=true&page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "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",
      "label": { "id": 8, "name": "Kelas XII IPA" },
      "created_at": "2026-07-30T09:00:00+07:00",
      "updated_at": "2026-07-30T09:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": {
      "total": 1,
      "per_page": 25,
      "current_page": 1,
      "last_page": 1,
      "from": 1,
      "to": 1
    }
  }
}

POST /participants — Membuat peserta

Peserta yang dibuat melalui API langsung berstatus terverifikasi. Email disimpan dalam huruf kecil. Jika peserta dengan email yang sama pernah dihapus dari projek, akun tersebut dipulihkan dan diperbarui dengan data yang dikirim.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`email`	Body	Ya	email	Harus unik pada projek, maksimal 255 karakter.
`name`	Body	Ya	string	Nama peserta, maksimal 255 karakter.
`password`	Body	Ya	string	Panjang 6–255 karakter.
`label_id`	Body	Tidak	integer/null	ID label milik projek.
`is_active`	Body	Tidak	boolean	Default `true`.

Contoh request

curl -X POST "https://app.indolat.com/api/v1/participants" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "budi@sekolah.sch.id",
    "name": "Budi Santoso",
    "password": "rahasia123",
    "label_id": 8,
    "is_active": true
  }'

Contoh response

Status 201.

{
  "success": true,
  "message": "Peserta berhasil dibuat.",
  "data": {
    "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",
    "label": { "id": 8, "name": "Kelas XII IPA" },
    "created_at": "2026-07-30T09:00:00+07:00",
    "updated_at": "2026-07-30T09:00:00+07:00"
  }
}

POST /participants/batch — Membuat atau memperbarui peserta secara batch

Peserta dicocokkan berdasarkan email. Format seluruh baris divalidasi lebih dulu: satu baris yang tidak valid membuat seluruh request ditolak dengan status 422, dan kunci error menunjuk ke baris tersebut (misalnya participants.3.email). Setelah lolos validasi, setiap baris diproses terpisah dan hasilnya dilaporkan per baris:

created — peserta baru dibuat, atau peserta yang pernah dihapus dipulihkan.
updated — peserta sudah ada dan update_existing bernilai true.
skipped — peserta sudah ada dan update_existing bernilai false. Item berisi reason.
failed — baris gagal diproses. Item berisi reason, tanpa participant_id.

Dengan update_existing: true, data peserta yang sudah ada diganti dengan isi baris: nama, kata sandi, dan label. Label dilepas jika label_id tidak dikirim, dan peserta yang sedang nonaktif diaktifkan kembali.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`participants`	Body	Ya	array	Berisi 1–500 peserta.
`participants.*.email`	Body	Ya	email	Email peserta, maksimal 255 karakter.
`participants.*.name`	Body	Ya	string	Nama peserta, maksimal 255 karakter.
`participants.*.password`	Body	Ya	string	Panjang 6–255 karakter.
`participants.*.label_id`	Body	Tidak	integer/null	ID label milik projek.
`update_existing`	Body	Tidak	boolean	Jika `true`, data peserta yang sudah ada diperbarui. Default `false`.

Contoh request

curl -X POST "https://app.indolat.com/api/v1/participants/batch" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "participants": [
      {
        "email": "budi@sekolah.sch.id",
        "name": "Budi Santoso",
        "password": "rahasia123",
        "label_id": 8
      },
      {
        "email": "siti@sekolah.sch.id",
        "name": "Siti Aminah",
        "password": "rahasia456",
        "label_id": 8
      }
    ],
    "update_existing": false
  }'

Contoh response

{
  "success": true,
  "message": "2 peserta dibuat, 0 diperbarui, 0 dilewati, 0 gagal.",
  "data": {
    "created": [
      { "index": 0, "email": "budi@sekolah.sch.id", "participant_id": 340 },
      { "index": 1, "email": "siti@sekolah.sch.id", "participant_id": 341 }
    ],
    "updated": [],
    "skipped": [],
    "failed": []
  },
  "meta": {
    "summary": { "total": 2, "created": 2, "updated": 0, "skipped": 0, "failed": 0 }
  }
}

GET /participants/{id} — Detail peserta

Parameter

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

Contoh request

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

Contoh response

{
  "success": true,
  "message": null,
  "data": {
    "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",
    "label": { "id": 8, "name": "Kelas XII IPA" },
    "created_at": "2026-07-30T09:00:00+07:00",
    "updated_at": "2026-07-30T09:00:00+07:00"
  }
}

PATCH /participants/{id} — Memperbarui peserta

Endpoint juga menerima metode PUT.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`id`	Path	Ya	integer	ID peserta.
`name`	Body	Tidak	string	Nama baru, maksimal 255 karakter.
`password`	Body	Tidak	string	Kata sandi baru, 6–255 karakter.
`label_id`	Body	Tidak	integer/null	ID label baru atau `null` untuk melepas label.
`is_active`	Body	Tidak	boolean	Status aktif baru.

Field yang tidak dikirim tidak diubah. Email tidak dapat diubah melalui API. Peserta dengan is_active: false tidak dapat masuk ke CBT, termasuk melalui link akses ujian.

Contoh request

curl -X PATCH "https://app.indolat.com/api/v1/participants/340" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Budi Santoso Putra",
    "label_id": 9,
    "is_active": true
  }'

Contoh response

{
  "success": true,
  "message": "Peserta berhasil diperbarui.",
  "data": {
    "id": 340,
    "name": "Budi Santoso Putra",
    "email": "budi@sekolah.sch.id",
    "is_active": true,
    "is_verified": true,
    "verified_at": "2026-07-30T09:00:00+07:00",
    "label": { "id": 9, "name": "Kelas XII" },
    "created_at": "2026-07-30T09:00:00+07:00",
    "updated_at": "2026-08-03T10:15:00+07:00"
  }
}

DELETE /participants/{id} — Menghapus peserta

Peserta yang masih terdaftar pada ujian tidak dapat dihapus; permintaan ditolak dengan status 409. Batalkan pendaftaran ujiannya terlebih dahulu melalui DELETE /exams/{exam}/participants/{participant}.

Parameter

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

Contoh request

curl -X DELETE "https://app.indolat.com/api/v1/participants/340" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": "Peserta berhasil dihapus.",
  "data": null
}

GET /participants/{id}/exams — Daftar ujian peserta

Diurutkan dari pendaftaran terbaru. results berisi satu item untuk setiap tes dalam ujian, dengan struktur yang sama seperti API Hasil Ujian.

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`id`	Path	Ya	integer	ID peserta.
`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/participants/340/exams?page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "user_exam_id": 4410,
      "participant_id": 340,
      "exam_id": 12,
      "participant_code": "TPA0000021",
      "status": 1,
      "status_label": "Aktif",
      "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"
      },
      "results": [
        {
          "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 },
          "start_at": "2026-08-10T08:05:00+07:00",
          "end_at": "2026-08-10T09:20:00+07:00",
          "duration_seconds": 4500,
          "created_at": "2026-07-30T10:00:00+07:00",
          "updated_at": "2026-08-10T09:20:00+07:00"
        }
      ],
      "registered_at": "2026-07-30T10:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1, "from": 1, "to": 1 }
  }
}

GET /participant-labels — Daftar label peserta

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`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/participant-labels?page=1&per_page=25" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json"

Contoh response

{
  "success": true,
  "message": null,
  "data": [
    {
      "id": 8,
      "name": "Kelas XII IPA",
      "participants_count": 32,
      "created_at": "2026-07-01T08:00:00+07:00",
      "updated_at": "2026-07-01T08:00:00+07:00"
    }
  ],
  "meta": {
    "pagination": { "total": 1, "per_page": 25, "current_page": 1, "last_page": 1, "from": 1, "to": 1 }
  }
}

POST /participant-labels — Membuat label peserta

Parameter

Nama	Lokasi	Wajib	Tipe	Keterangan
`name`	Body	Ya	string	Nama unik pada projek, maksimal 255 karakter.

Contoh request

curl -X POST "https://app.indolat.com/api/v1/participant-labels" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Kelas XII IPA" }'

Contoh response

{
  "success": true,
  "message": "Label berhasil dibuat.",
  "data": {
    "id": 8,
    "name": "Kelas XII IPA",
    "created_at": "2026-08-03T10:00:00+07:00",
    "updated_at": "2026-08-03T10:00:00+07:00"
  }
}

​Endpoint peserta

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

​Parameter

​Contoh request

​Contoh response

Endpoint peserta

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response

Parameter

Contoh request

Contoh response