###GET /kyc/v2/clients/{clientId}/deathStatusInquiry
* **شرح: ** این سرویس با دریافت کدملی و تاریخ تولد، وضعیت حیات که یکی از مقادیر زنده یا مرده است را در خروجی نمایش میدهد. این سرویس از ساعت ۲۳:۰۰ تا ساعت ۷:۰۰ غیر فعال است . در صورتی که در این بازه سرویس را فراخوانی کنید با خطای 'شما در بازه زمانی تعریف شده قرار ندارید' مواجه خواهید شد .
* **اسکوپ: ** ```kyc:death-status-inquiry:get```
* **رویکرد: ** ```Client-Credential```
* ** دانلود مستندات ریسپانس کد ها **
````````````````
{address}/kyc/v2/clients/{clientId}/deathStatusInquiry?trackId={trackId}&nationalCode={nationalCode}&birthDate={birthDate}
````````````````
https://sandboxapi.finnotech.ir :address
https://apibeta.finnotech.ir :address
#### Headers
مقادیر زیر باید در هدر قرار بگیرد
````````````````
Authorization : Bearer {Token}
````````````````
#### URI Parameters
* **clientId :** (اجباری) شناسه کلاینت
#### Query Parameters
* **trackId:** اختیاری (string) کد پیگیری، رشته ای اختیاری با طول حداکثر ۴۰ کاراکتر شامل حرف و عدد. در صورت ارسال trackId، فراخوانی سرویس خود را با همین مقدار استعلام و پیگیری کنید.(در گزارش فراخوانی سرویس ها با همین رشته نتیجه را ببینید). در صورتیکه که این فیلد را ارسال نکنید یک رشته UUID برای این فراخوانی در نظر گرفته میشود و در پاسخ فراخوانی برگردانده میشود.
* example: ```9602281200```
* **nationalCode:** کد ملی
* **birthDate:** تاریخ تولد صاحب کد ملی که اجباری است، به صورت yyyy/mm/dd
###Results Format
#### Successful result format (status code 200)
* فیلدهای زیر را در پاسخ مشاهده میکنید.
````````````````
{
"trackId": "9602281200",
"responseCode": "FN-KCFH-20002500000",
"result": {
"deathStatus": "زنده",
"trackingCode": "123"
},
"status": "DONE"
}
````````````````
* **deathStatus:** وضعیت حیات که یکی از مقادیر زنده|مرده را دارد
* **trackingCode:** کد رهگیری ثبت احوال
* **trackId:** کد پیگیری، اگر ارسال شده باشد همان مقدار برگردانده میشود و در غیر اینصورت یک رشته تصادفی تولید و برگردانده میشود
* **status:** وضعیت فراخوانی که میتواند یکی از موارد DONE|FAILED باشد
#### UnSuccessful result format
در اینجا میتوانید لیست خطاهای سرویس ها را مشاهده کنید [لیست خطاها](/doc/generic-errors.html)