# POST /b2c/v1/get_country

<div class="api-docs" id="bkmrk-">  <div class="endpoint-section">  
</div></div>## Get Nationalities List

این اندپوینت لیست کشورهای فعال که دارای عنوان «ملیت» (Nationality) تعریف شده هستند را باز می‌گرداند.   
از این داده‌ها معمولاً در فرم‌های ورود اطلاعات مسافر جهت انتخاب **ملیت/تابعیت** (مثلاً: ایرانی، آلمانی و...) استفاده می‌شود. لیست خروجی تنها شامل رکوردهایی است که وضعیت آن‌ها فعال (`status = 1`) باشد.

<div class="api-docs" id="bkmrk--1"><div class="endpoint-section">  
</div>  
---

  </div># Fetch Country/Nationality Data

<div class="api-docs" id="bkmrk-url%3A-%2Fb2c%2Fv1%2Fget_cou"><div class="endpoint-info"><div>**URL:** `/b2c/v1/get_country`</div><div>**Method:** <span class="method-post">POST</span></div><div>**Controller:** V1UserController@getCitizen</div><div>**Auth:** Public (Guest Access)</div></div></div>### Parameters

این درخواست نیاز به پارامتر ورودی (Body Parameters) ندارد.

<div class="api-docs" id="bkmrk--2">  </div>### Response Structure

<div class="api-docs" id="bkmrk-key-type-description"><table class="schema-table" dir="rtl"><thead><tr><th>Key</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td dir="ltr">status</td><td>Boolean</td><td>وضعیت درخواست (true).</td></tr><tr><td dir="ltr">data.countries</td><td>Array</td><td>آرایه‌ای از آبجکت‌های کشور/ملیت.</td></tr><tr><td dir="ltr">↳ id</td><td>Integer</td><td>شناسه عددی کشور در دیتابیس.</td></tr><tr><td dir="ltr">↳ iso</td><td>String</td><td>کد دو حرفی ایزو کشور (مثلاً IR, US).</td></tr><tr><td dir="ltr">↳ fa\_nationality</td><td>String</td><td>عنوان فارسی ملیت (مثلاً: ایرانی).</td></tr><tr><td dir="ltr">↳ en\_nationality</td><td>String</td><td>عنوان انگلیسی ملیت (مثلاً: Iranian).</td></tr></tbody></table>

</div>### Example Responses

**۱. موفقیت آمیز (200 OK):**

```json
{
    "status": true,
    "time": 1702138899,
    "data": {
        "countries": [
            {
                "id": 105,
                "iso": "IR",
                "fa_nationality": "ایرانی",
                "en_nationality": "Iranian"
            },
            {
                "id": 220,
                "iso": "TR",
                "fa_nationality": "ترک",
                "en_nationality": "Turkish"
            },
            {
                "id": 68,
                "iso": "DE",
                "fa_nationality": "آلمانی",
                "en_nationality": "German"
            }
        ]
    }
}
```

**۲. خطای سرور (400 Bad Request):**

```json
{
    "status": false,
    "error": "Database connection error..."
}
```

<div class="api-docs" id="bkmrk--3">---

  </div>### Technical Logic

<div class="api-docs" id="bkmrk-request-received-%E2%86%93-q"><div class="flowchart"><div class="flow-item">Request Received</div><div class="flow-arrow">↓</div><div class="flow-item-process">**Query Database (Countries)**  
`WHERE status = 1`  
`AND fa_nationality IS NOT NULL`</div><div class="flow-arrow">↓</div><div class="flow-item-process">**Select Columns**  
id, iso, fa_nationality, en_nationality</div><div class="flow-arrow">↓</div><div class="flow-item-success">Return JSON Response</div></div></div>