You need to enable JavaScript to use this application.
POST شناخت کسب‌وکار

Authorized Signatories API

Returns authorized signatories and newspaper signature text for an Iranian company by national ID (11 digits).

POST /api/services/authorized-signatories/
نیاز به احراز هویت Token 60 requests/minute

مستندات

Overview

Overview

با شناسه ملی ۱۱ رقمی شرکت، صاحبان امضا و متن روزنامه رسمی برمی‌گردد.

Billing

Billing

فقط در صورت موفقیت استعلام از کیف پول کسر می‌شود.

IP Whitelist

IP Whitelist

Every request is checked against the IP list registered on your account (dashboard → security settings). Requests from any other IP — or from any IP when no IP is registered — are rejected with 403 IP_NOT_ALLOWED (checked right after token authentication, before the provider is called; nothing is charged).

{
  "success": false,
  "error": {
    "code": "IP_NOT_ALLOWED",
    "message": "درخواست از آدرس IP ثبت‌نشده ارسال شده است. فقط IPهای ثبت‌شده مجاز هستند.",
    "details": {"client_ip": "203.0.113.10"}
  }
}

details.client_ip shows the IP the server saw; register exactly that public IP of your server.

پارامترهای درخواست

پارامتر نوع اجباری توضیحات مثال
company_national_id String اجباری Iranian company national ID (شناسه ملی شرکت), exactly 11 digits.
اعتبارسنجی: Exactly 11 numeric digits.
14014461405

مثال‌های کد

Python Example

Example using Python requests.

import requests

url = "https://inquiry.sepal.ir/api/services/authorized-signatories/"
headers = {
    "Authorization": "Token YOUR_AUTH_TOKEN",
    "X-Unique-Code": "YOUR_UNIQUE_CODE",
    "Content-Type": "application/json",
}
payload = {"company_national_id": "14014461405"}
print(requests.post(url, json=payload, headers=headers).json())
cURL Example

Command-line cURL example.

curl -X POST "https://inquiry.sepal.ir/api/services/authorized-signatories/" \
  -H "Authorization: Token YOUR_AUTH_TOKEN" \
  -H "X-Unique-Code: YOUR_UNIQUE_CODE" \
  -H "Content-Type: application/json" \
  -d '{"company_national_id": "14014461405"}' 

فرمت پاسخ

200
پاسخ موفق

Authorized signatories returned; wallet charged.

ساختار پاسخ:
{
  "amount": "integer",
  "success": "boolean",
  "request_ref": "string",
  "response_data": "object",
  "response_time_ms": "integer"
}
مثال پاسخ:
{
  "amount": 25000,
  "success": true,
  "request_ref": "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345",
  "error_message": null,
  "response_data": {
    "ref_id": "a6fd38c4-253a-461d-a47d-af3ad4200a6a",
    "news_id": "11111111",
    "company_title": "فین و تک پارس",
    "newspaper_date": "2023-12-14T00:00:00",
    "operation_time": 1762629953669,
    "signholders_status": {
      "normal_signature": {
        "holders": [],
        "relationships": []
      },
      "obligatory_signature": {
        "holders": [],
        "relationships": []
      }
    },
    "signature_item_full_text": "کلیه اسناد و اوراق بهادار..."
  },
  "response_time_ms": 2100
}
400
خطا

Invalid company_national_id.

ساختار پاسخ:
{
  "error": "object",
  "success": "boolean"
}
مثال پاسخ:
{
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "پارامترهای ورودی نامعتبر است."
  },
  "success": false
}
401
خطا

Missing or invalid Authorization token / X-Unique-Code. Body is DRF's {"detail": ...} (no success/error envelope). No charge.

ساختار پاسخ:
{
  "detail": "string"
}
مثال پاسخ:
{
  "detail": "Invalid registration source credentials. Token or unique code is incorrect or inactive."
}
402
خطا

Wallet balance is below the service tariff (25,000 Rials), or in-flight requests already reserve it. The provider is not called. No charge.

ساختار پاسخ:
{
  "error": {
    "code": "string",
    "details": "object (optional)",
    "message": "string"
  },
  "success": "boolean (false)"
}
مثال پاسخ:
{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "موجودی ناکافی. موجودی فعلی: 0 ریال، مبلغ مورد نیاز: 25,000 ریال"
  },
  "success": false
}
403
خطا

Request IP is not in the account's registered IP list (or no IP is registered). Register the server IP in the dashboard. No charge.

ساختار پاسخ:
{
  "error": {
    "code": "string",
    "details": {
      "client_ip": "string"
    },
    "message": "string"
  },
  "success": "boolean (false)"
}
مثال پاسخ:
{
  "error": {
    "code": "IP_NOT_ALLOWED",
    "details": {
      "client_ip": "203.0.113.10"
    },
    "message": "درخواست از آدرس IP ثبت‌نشده ارسال شده است. فقط IPهای ثبت‌شده مجاز هستند."
  },
  "success": false
}
502
خطا

Upstream provider unreachable or failed. When the provider answers with its own 5xx, that status is returned with error.errors[0].code = SERVICE_UNAVAILABLE. No charge.

ساختار پاسخ:
{
  "error": {
    "code": "string",
    "details": "object (optional)",
    "message": "string"
  },
  "success": "boolean (false)"
}
مثال پاسخ:
{
  "error": {
    "code": "SERVICE_ERROR",
    "message": "سرویس استعلام در دسترس نیست. لطفاً دوباره تلاش کنید."
  },
  "success": false
}