读取注册资料

读取一份已存储的资料

通过 UUID 获取当前账户内对应的有效本地注册资料。返回的资料字段范围有限，与以下函数相同：documents；此操作不会刷新运营商验证结果，也不会返回已附加的证明材料。

资料请求

使用已启用的 MultiTEL API 账户及其获准的 IP 地址进行身份验证。示例使用存储在环境变量中的 HTTP Basic 凭据。请同时检查 HTTP 响应以及 JSON 中的 status.code；仅收到 HTTP 200 响应并不能确认操作成功。所有示例值均为虚构。

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

将 DOCUMENT_UUID 设置为 response.uuid，该值来自 create_document，或者使用 documents 返回的 response[].id。此处不要使用 identity_id、address_id、证明材料 ID 或电话号码。无需请求体。

资料响应

{
  "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"
  }
}

返回的资料字段

返回的字段集合包含 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 和 date_created。

根据存储的数据，可选值可能为空或 null。这套旧版返回字段不包含 email、国家选择字段、identity_id、address_id、已上传文件的引用、证明材料列表及验证状态。此端点不用于查询证明材料状态或注册审批结果。请将返回的身份、联系方式及签名数据视为私密数据。

未找到资料与重试

API 代码为 404 且消息为 Failed, Not found 时，表示未找到与此账户及 UUID 匹配的有效资料。请检查账户、标识符以及资料是否已被删除。此查询不会泄露其他账户的资料。

读取成功并不能确认材料已获认可或号码已激活。如果先前的创建或添加附件请求结果不确定，而您正在处理这一情况，请先查看门户中的文档，再发出其他会改变状态的请求。