Baca profil pendaftaran

Baca satu profil tersimpan

Ambil profil pendaftaran lokal yang aktif dalam akun Anda berdasarkan UUID-nya. Operasi ini mengembalikan kumpulan bidang profil terbatas yang sama dengan documents; operasi ini tidak memperbarui verifikasi operator atau mengembalikan dokumen bukti yang dilampirkan.

Permintaan profil

Lakukan autentikasi menggunakan akun API MultiTEL Anda yang telah diaktifkan dan alamat IP yang diizinkan untuk akun tersebut. Contoh menggunakan kredensial HTTP Basic yang disimpan dalam variabel lingkungan. Periksa respons HTTP serta nilai JSON status.code; respons HTTP 200 saja tidak memastikan keberhasilan. Semua nilai dalam contoh bersifat fiktif.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"

Tetapkan DOCUMENT_UUID ke nilai response.uuid dari create_document, atau response[].id dari documents. Jangan gunakan identity_id, address_id, ID dokumen bukti, atau nomor telepon di sini. Tidak diperlukan isi permintaan.

Respons profil

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": {
    "id": "11111111111111111111111111111111",
    "first_name": "Example",
    "last_name": "Person",
    "phone_number": "12025550123",
    "id_number": "",
    "birth_date": null,
    "company_name": "",
    "company_reg_number": "",
    "vat_id": "",
    "personal_tax_id": "",
    "description": "Example profile",
    "identity_type": "Personal",
    "postal_code": "00000",
    "city": "Example City",
    "address": "1 Example Street",
    "signature": "BASE64_PNG_SIGNATURE_DATA",
    "date_created": "2026-10-23 16:00:00"
  }
}

Bidang profil yang dikembalikan

Kumpulan bidang yang dipilih untuk dikembalikan mencakup id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature dan date_created.

Nilai opsional dapat kosong atau null, sesuai data yang tersimpan. Kumpulan bidang yang dikembalikan dengan mekanisme lama ini tidak menyertakan email, bidang pemilihan negara, identity_id, address_id, referensi berkas yang diunggah, daftar dokumen bukti, dan status verifikasi. Ini bukan endpoint untuk status dokumen bukti atau persetujuan pendaftaran. Perlakukan data identitas, kontak, dan tanda tangan yang dikembalikan sebagai data pribadi.

Tidak ditemukan dan percobaan ulang

Kode API 404 dengan pesan Failed, Not found berarti tidak ditemukan profil aktif yang cocok dengan akun dan UUID ini. Periksa akun, pengenal, dan apakah profil telah dihapus. Pencarian ini tidak mengungkapkan profil milik akun lain.

Pembacaan yang berhasil tidak memastikan bahwa dokumen bukti telah diterima atau nomor telah diaktifkan. Jika Anda melanjutkan proses setelah permintaan pembuatan atau pelampiran yang hasilnya tidak pasti, periksa dokumen di portal sebelum mengirim permintaan lain yang mengubah keadaan.