# GET /api/v2/salary/annual-obligation

<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/salary/annual-obligation</td><td style="direction: ltr; padding: 10px;">OfficialController@salaryAnnualObligation</td></tr></tbody></table>

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

این متد اطلاعات مربوط به تعهدات مالی و پارامترهای محاسباتی حقوق و دستمزد (مانند پایه حقوق، سقف مالیاتی، حق مسکن و...) را برای یک سال مالی مشخص بازیابی می‌کند.

<div id="bkmrk-%D8%AC%D8%B3%D8%AA%D8%AC%D9%88-%D8%A8%D8%B1-%D8%A7%D8%B3%D8%A7%D8%B3-%D8%B3%D8%A7%D9%84%3A-%D8%B3" style="direction: rtl; font-family: Vazir,Tahoma; text-align: justify; line-height: 1.85;">- **جستجو بر اساس سال:** سیستم در جدول `salary_annual_obligation` رکوردهایی که فیلد `year` آن‌ها با ورودی کاربر مطابقت دارد را جستجو می‌کند.
- **بررسی وجود داده:**
    - اگر اطلاعاتی پیدا شود، لیست رکوردها بازگردانده می‌شود.
    - اگر رکوردی برای سال مورد نظر وجود نداشته باشد، خروجی با `status: false` و پیام "There is no data available" ارسال می‌شود.

</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;">year</td><td>Integer</td><td>بله</td><td>سال مورد نظر برای دریافت تعهدات مالی (مثلاً 1403).</td></tr></tbody></table>

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

```
{
    "status": true,
    "time": 1732629000,
    "data": [
        {
            "id": 5,
            "year": 1403,
            "min_salary": 70000000,
            "housing_allowance": 9000000,
            "description": "بخشنامه حقوق سال 1403",
            "created_at": "2024-03-20 10:00:00"
        }
    ]
}
```