مرجع api / commercial/companies/{nid}/legal-notes/
اطلاعیه‌های روزنامه رسمی
تازه‌ترین اطلاعیه‌های قانونی شرکت.
GET
commercial/companies/{national_id}/legal-notes/فهرست تازه‌ترین اطلاعیه‌های قانونی شرکت در روزنامه رسمی (به ترتیب نزولی تاریخ روزنامه). برای مانیتورینگ تغییرات هیئت‌مدیره، انحلال، افزایش سرمایه و سایر تغییرات ثبت‌شده مناسب است.
نیازمند اعتبار20 درخواست در دقیقه
هدرها
X-API-KEYstringبلهکلید api شما.
پارامترهای کوئری
national_idstringبلهشناسه ملی شرکت.
idempotency_keystringبلهUUID یکتا.
limitintegerdefault:
20تعداد اطلاعیه‌ها (۱ تا ۱۰۰، پیش‌فرض ۲۰).
نمونه درخواست
curl -X GET 'https://www.saravar.com/api/commercial/companies/12345678901/legal-notes/?limit=10&idempotency_key=550e8400-e29b-41d4-a716-446655440000' \-H 'X-API-KEY: <YOUR_API_KEY>'
پاسخ
debit_transaction_idinteger | nullبلهشناسه تراکنش.
total_chargedintegerبلهمبلغ کسر شده بر حسب IRR.
dataLegalNote[]بلهآرایهای از { id_code, title, letter_date, newspaper_date, note_type, title_summary }.
نکات قیمت‌گذاری و رفتار
- هزینه به ازای هر اطلاعیه بازگشتی محاسبه می‌شود.
- حداقل کارمزد به ازای هر فراخوانی موفق اعمال می‌شود.
خطاها
400کد وضعیتعلتidempotency_key مفقود یا insufficient_credits.
اقدام پیشنهادیکلید معتبر ارسال کنید یا شارژ کنید.
401کد وضعیتعلتکلید api نامعتبر است.
اقدام پیشنهادیکلید فعال بسازید.
403کد وضعیتعلتاحراز هویت ملی تکمیل نشده.
اقدام پیشنهادیاحراز هویت را تکمیل کنید.
404کد وضعیتعلتشرکت یافت نشد.
اقدام پیشنهادیشناسه ملی را بررسی کنید.
429کد وضعیتعلتاز سقف نرخ عبور کرده‌اید.
اقدام پیشنهادیbackoff اعمال کنید.