Liệt kê hồ sơ đăng ký

Tìm hồ sơ đăng ký hiện có

Liệt kê các hồ sơ đăng ký cục bộ đang hoạt động, chưa bị xóa và được liên kết với tài khoản API của bạn. Dùng danh sách này để tìm UUID của hồ sơ trước khi mở hồ sơ bằng get_document, không dùng để xác định liệu các giấy tờ chứng minh của hồ sơ hoặc việc đăng ký số điện thoại đã được phê duyệt hay chưa.

Yêu cầu lấy danh sách

Xác thực bằng tài khoản API MultiTEL đã được kích hoạt của bạn và địa chỉ IP được phép của tài khoản đó. Các ví dụ sử dụng thông tin xác thực HTTP Basic được lưu trong các biến môi trường. Kiểm tra cả phản hồi HTTP lẫn trường JSON status.code; chỉ riêng phản hồi HTTP 200 không đủ để xác định yêu cầu đã thành công. Tất cả giá trị trong ví dụ đều là giả định.

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

Trình xử lý này không hỗ trợ nội dung yêu cầu, phân trang hoặc tham số lọc. Trình xử lý trả về các hồ sơ đã lưu của tài khoản tương ứng; đừng mặc định rằng kết quả có một thứ tự cụ thể. Tránh truy vấn lặp lại toàn bộ danh sách với tần suất cao đối với các tài khoản lớn.

Danh sách trong phản hồi

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "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"
    }
  ]
}

Khi không có hồ sơ đang hoạt động nào phù hợp, trình xử lý trả về mã API 200 và danh sách phản hồi rỗng. response[].id là UUID của hồ sơ cục bộ, được trả về dưới tên uuid khi tạo; đây không phải là ID danh tính hay ID địa chỉ.

Các trường hồ sơ được trả về

Tập hợp trường được trả về gồm 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 và date_created.

Các giá trị không bắt buộc có thể rỗng hoặc là null, tùy theo dữ liệu đã lưu. Tập hợp trường theo cơ chế cũ này không bao gồm email, các trường chọn quốc gia, identity_id, address_id, các tham chiếu đến tệp đã tải lên, danh sách giấy tờ chứng minh và trạng thái xác minh. Đây không phải là điểm cuối để tra cứu trạng thái giấy tờ chứng minh hoặc việc phê duyệt đăng ký. Hãy coi dữ liệu danh tính, thông tin liên hệ và chữ ký được trả về là thông tin riêng tư.

Các bước tiếp theo

Lưu các ID thực thể từ phản hồi ban đầu của create_document để dùng khi đính kèm về sau. Nếu phản hồi đó đã bị mất, danh sách này không thể khôi phục các ID đó. Kiểm tra hồ sơ trong cổng thông tin hoặc liên hệ bộ phận hỗ trợ thay vì tự động tạo một hồ sơ trùng lặp.