> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# سرد قوائم العملاء المحتملين

> GET /lead/

قوائم العملاء المحتملين (Lead Lists) هي ميزة التقاط العملاء المحتملين الأصلية في Scanova — تعريف نموذج (`data`) مُرفق بصفحة هبوط رمز QR. اسردها أو أنشئها هنا.

<Warning>
  قوائم العملاء المحتملين ميزة **قديمة**. لوحة تحكم Scanova توجّه الآن حالات استخدام التقاط العملاء المحتملين الجديدة نحو [النماذج](/ar/api-reference/management-api/forms/create) بدلًا منها، والتي تغطي حالة الاستخدام نفسها "جمع بيانات الزوار من مسح رمز QR" بأداة بناء أكثر قدرة. قوائم العملاء المحتملين الحالية تستمر في العمل، ونقطة النهاية هذه غير متأثرة، لكن ابنِ عمليات تكامل جديدة على أساس النماذج ما لم تكن بحاجة تحديدًا إلى إدارة قائمة عملاء محتملين موجودة مسبقًا.
</Warning>

<Note>
  يتطلب مفتاح Management API بحصة `MANAGEMENT_API` (أو `MANAGEMENT_API_SANDBOX`)، يُرسل كقيمة خام لترويسة `Authorization` — راجع [نظرة عامة على Management API](/ar/api-reference/management-api/overview).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://management.scanova.io/lead/' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 0,
    "next": null,
    "previous": null,
    "results": []
  }
  ```
</ResponseExample>

<Note>
  تم التحقق منه مباشرة مقابل حساب اختباري بلا قوائم عملاء محتملين — لذا `results` فارغة. نقطة النهاية هذه تعيد فقط قوائم العملاء المحتملين التي **لم** تُحوَّل إلى نموذج (Form)؛ بمجرد تحويل قائمة عملاء محتملين (عبر تدفق "Migrate to Form" في لوحة التحكم)، تسقط من هذه القائمة نهائيًا وتصبح متاحة فقط عبر نقاط نهاية النماذج.
</Note>

<ParamField query="is_active" type="boolean">
  تصفية حسب القوائم الفعّالة (`true`) أو غير الفعّالة (`false`). قوائم العملاء المحتملين غير الفعّالة لا تعرض نموذجها على صفحة الهبوط.
</ParamField>

### حقول الاستجابة (لكل عنصر)

<ResponseField name="id" type="integer" />

<ResponseField name="lead_id" type="string">
  معرّف قائمة عملاء محتملين فريد وثابت.
</ResponseField>

<ResponseField name="name" type="string">
  اسم داخلي — لا يظهر في صفحة الهبوط العامة.
</ResponseField>

<ResponseField name="is_active" type="boolean" />

<ResponseField name="usage_count" type="integer">
  عدد رموز QR المرفقة حاليًا بقائمة العملاء المحتملين هذه.
</ResponseField>

<ResponseField name="entries_count" type="integer">
  إجمالي عدد إرسالات العملاء المحتملين التي تم جمعها.
</ResponseField>

<ResponseField name="linked_qrs" type="array">
  رموز QR المرفقة بقائمة العملاء المحتملين هذه.
</ResponseField>

<ResponseField name="created" type="string" />

<ResponseField name="modified" type="string" />

## ذات صلة

* [إنشاء قائمة عملاء محتملين](/ar/api-reference/management-api/leads/create) — العملية الأخرى لنفس نقطة النهاية هذه.
* [إدارة النماذج](/ar/api-reference/management-api/forms/create) — أداة بناء التقاط العملاء المحتملين الحالية والموصى بها التي يُوجَّه إليها استخدام هذه الميزة القديمة.
* [نظرة عامة على Management API](/ar/api-reference/management-api/overview) — مخطط المصادقة وبنية الحصص التي تنتمي إليها نقطة النهاية هذه.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /lead/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.scanova.io (QR codes, folders, tags, leads, forms, analytics,
    plans, shared users & roles), plus the token-creation and usage-stats
    endpoints used to authenticate against it. Every path and request/response
    shape below was verified live against a real API key and the actual running
    backend (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /lead/:
    get:
      summary: List lead lists
      operationId: listManagedLeadLists
      responses:
        '200':
          description: List of lead lists
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````