# GET /api/v2/exams/list

<div id="bkmrk-" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"></div>### Route Info

<div id="bkmrk-method-endpoint-cont" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; margin: auto; border-collapse: collapse; text-align: center; border: 1px solid #ddd;"><tbody><tr style="background: #f4f4f4; font-weight: bold;"><td style="padding: 10px;">Method</td><td style="padding: 10px;">Endpoint</td><td style="padding: 10px;">Controller</td></tr><tr><td style="direction: ltr; padding: 10px;">GET</td><td style="direction: ltr; padding: 10px;">/api/v2/exams/list</td><td style="direction: ltr; padding: 10px;">OfficialController@listExams</td></tr></tbody></table>

</div></div>### شرح عملکرد (Functionality)

این متد لیست تمامی آزمون‌های فعال مرتبط با شعبه جاری را استخراج کرده و آماری از وضعیت هر آزمون ارائه می‌دهد:

<div id="bkmrk-%D9%81%DB%8C%D9%84%D8%AA%D8%B1-%D8%A2%D8%B2%D9%85%D9%88%D9%86%E2%80%8C%D9%87%D8%A7%3A-%D8%AA%D9%86%D9%87%D8%A7" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;">- **فیلتر آزمون‌ها:** تنها آزمون‌هایی که فیلد `status` آن‌ها برابر با 1 است و متعلق به `branch` درخواست‌کننده هستند، انتخاب می‌شوند.
- **محاسبه آمار (Statistics):** برای هر آزمون، دو مقدار محاسبه می‌شود: 
    - `requests`: تعداد کل سوالات تعریف شده برای آن آزمون (از جدول `exam_questions`).
    - `answers`: تعداد کل پاسخ‌نامه‌های ثبت شده توسط کاربران (از جدول `exam_response`).

</div>### پارامترهای ورودی (Input Parameters)

<div id="bkmrk-%D9%86%D8%A7%D9%85-%D9%BE%D8%A7%D8%B1%D8%A7%D9%85%D8%AA%D8%B1-%D9%86%D9%88%D8%B9-%D8%A7%D9%84%D8%B2%D8%A7" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;"><div><table border="1" style="width: 100%; border-collapse: collapse; text-align: right;"><thead><tr style="background: #f4f4f4;"><th style="padding: 8px;">نام پارامتر</th><th style="padding: 8px;">نوع</th><th style="padding: 8px;">الزامی؟</th><th style="padding: 8px;">توضیحات</th></tr></thead><tbody><tr><td style="direction: ltr;">branch</td><td>Integer</td><td>بله</td><td>شناسه شعبه (این مقدار معمولاً از توکن احراز هویت استخراج می‌شود).</td></tr></tbody></table>

</div></div>### نمونه خروجی (Response)

```
{
    "status": true,
    "time": 1732626000,
    "data": [
        {
            "id": 10,
            "type": "general",
            "title": "آزمون جامع نیمسال اول",
            "requests": 25,
            "answers": 140
        },
        {
            "id": 12,
            "type": "specialized",
            "title": "آزمون تخصصی فنی",
            "requests": 10,
            "answers": 45
        }
    ]
}
```