رجسٹریشن پروفائلز کی فہرست حاصل کریں

موجودہ رجسٹریشن پروفائلز تلاش کریں

اپنے API اکاؤنٹ سے وابستہ فعال مقامی رجسٹریشن پروفائلز کی فہرست حاصل کریں جنہیں حذف نہیں کیا گیا ہے۔ پروفائل کا UUID تلاش کرنے کے لیے یہ فہرست استعمال کریں، اس سے پہلے کہ آپ اسے کھولنے کے لیے یہ استعمال کریں: get_document؛ اس فہرست کو یہ معلوم کرنے کے لیے استعمال نہ کریں کہ آیا اس کی ثبوتی دستاویزات یا نمبر کی رجسٹریشن منظور ہو چکی ہے۔

فہرست حاصل کرنے کی درخواست

اپنے فعال 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/documents

اس ہینڈلر میں درخواست کا باڈی، صفحہ بندی یا فلٹر کے پیرامیٹرز نافذ نہیں کیے گئے ہیں۔ یہ متعلقہ اکاؤنٹ کے محفوظ شدہ پروفائلز واپس کرتا ہے؛ کسی خاص ترتیب کا مفروضہ قائم نہ کریں۔ بڑے اکاؤنٹس کے لیے پوری فہرست بار بار طلب کرنے سے گریز کریں۔

جواب میں ملنے والی فہرست

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

کوئی متعلقہ فعال پروفائل نہ ملنے پر ہینڈلر API کوڈ 200 اور جواب میں ایک خالی فہرست واپس کرتا ہے۔ response[].id مقامی پروفائل کا UUID ہے جو تخلیق کے وقت uuid کے طور پر واپس کیا جاتا ہے؛ یہ شناخت کا ID یا پتے کا ID نہیں ہے۔

واپس کیے جانے والے پروفائل فیلڈز

منتخب فیلڈز میں یہ شامل ہیں: 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، اپ لوڈ کردہ فائلوں کے حوالے، ثبوتی دستاویزات کی فہرستیں اور تصدیق کی کیفیت شامل نہیں ہیں۔ یہ ثبوتی دستاویزات کی کیفیت یا رجسٹریشن کی منظوری معلوم کرنے کا اینڈ پوائنٹ نہیں ہے۔ واپس کیے گئے شناخت، رابطے اور دستخط کے ڈیٹا کو نجی سمجھیں۔

اگلے اقدامات

بعد میں منسلکات کے لیے اصل create_document کے جواب سے متعلقہ اکائیوں کے IDs محفوظ کر لیں۔ اگر وہ جواب گم ہو گیا ہو تو یہ فہرست ان IDs کو بازیاب نہیں کر سکتی۔ پروفائل کا معائنہ کرنے کے لیے پورٹل استعمال کریں یا خودکار طور پر نقل بنانے کے بجائے معاونت سے رابطہ کریں۔