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

Company Licenses API

Returns company licenses (Enamad, knowledge-based, License.ir, production, and others) by Iranian company national ID.

POST /api/services/company-licenses/
نیاز به احراز هویت 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.
14007111888

مثال‌های کد

Python Example

Example using Python requests.

import requests

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

Command-line cURL example.

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

فرمت پاسخ

200
پاسخ موفق

Company licenses 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": "trackID",
    "operation_time": 1762629953669,
    "other_licenses": [],
    "total_licenses": 1,
    "enamad_licenses": [
      {
        "type": "Enamad",
        "title": "اینماد",
        "status": "فعال",
        "is_active": true,
        "certificate_number": "123"
      }
    ],
    "license_ir_licenses": [],
    "production_licenses": [],
    "knowledge_based_licenses": []
  },
  "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
}