مرجع api / commercial/companies/{nid}/board-members/
اعضای هیئت‌مدیره فعال
تمام نقش‌های فعال شرکت (هیئت‌مدیره، بازرسان، تصفیه‌کنندگان و ...).
GET
commercial/companies/{national_id}/board-members/تمام نقش‌های فعال شرکت را برمی‌گرداند: مدیرعامل، رئیس و نواب رئیس هیئت‌مدیره، اعضای هیئت‌مدیره، بازرسان و دیگر سمت‌ها. ساختار پاسخ مشابه signatories/ است اما بدون فیلتر روی نوع نقش.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شرکت (۱۱ رقم).
idempotency_keystringبلهUUID یکتا.
نمونه درخواست
curl -X GET 'https://www.saravar.com/api/commercial/companies/12345678901/board-members/?idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش کسر اعتبار.
total_chargedintegerبلهمبلغ کسر شده بر حسب IRR.
dataRoleAssignment[]بلهآرایهای از { person, role_name, role_type, date_assigned, expire_date } — شامل تمام نقش‌های فعال.
نکات قیمت‌گذاری و رفتار
- هزینه به ازای هر رکورد بازگشتی محاسبه می‌شود.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.
خطاها
400کد وضعیتعلتidempotency_key مفقود است یا insufficient_credits.
اقدام پیشنهادیکلید idempotency معتبر ارسال کنید یا شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را در داشبورد تکمیل کنید.
404کد وضعیتعلتشرکت یافت نشد.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.