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

Enamad Verify API

Returns Enamad summary + profile by website domain (status, owner, phone, email, address, approval/expiry dates).

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

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

پارامتر نوع اجباری توضیحات مثال
domain String اجباری Website domain (scheme/path optional).
اعتبارسنجی: Valid domain; http/https prefix is stripped.
simorghma.ir

مثال‌های کد

Python Example

Example using Python requests.

import requests

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

Command-line cURL example.

curl -X POST "https://inquiry.sepal.ir/api/services/enamad-verify/" \
  -H "Authorization: Token YOUR_AUTH_TOKEN" \
  -H "X-Unique-Code: YOUR_UNIQUE_CODE" \
  -H "Content-Type: application/json" \
  -d '{"domain": "simorghma.ir"}' 

فرمت پاسخ

200
پاسخ موفق

Enamad status returned; wallet charged.

ساختار پاسخ:
{
  "amount": "integer",
  "success": "boolean",
  "request_ref": "string",
  "response_data": "object",
  "response_time_ms": "integer"
}
مثال پاسخ:
{
  "amount": 50000,
  "success": true,
  "request_ref": "ABCDEFGHIJKLMNOPQRSTUVWXYZ012345",
  "error_message": null,
  "response_data": {
    "city": "سایر",
    "email": "info@simorghma.ir",
    "phone": "08348583202",
    "domain": "simorghma.ir",
    "rating": 1,
    "ref_id": "abee0f-6c9e-fe88d-5a0",
    "status": "معتبر",
    "address": "استان : کرمانشاه - شهرستان : کنگاور",
    "decision": "VALID",
    "province": "سایر",
    "enamad_id": "676117",
    "owner_name": "جهان نگین رستا",
    "code_masked": "LM1Jht51418f********",
    "expiry_date": "1406/09/01",
    "profile_url": "https://trustseal.enamad.ir/?id=676117&code=LM1Jht51418f********",
    "approval_date": "1404/09/01",
    "business_name": "سیمرغ ما",
    "business_type": null,
    "profile_error": null,
    "validity_date": "1406/09/01",
    "operation_time": 1762629953669,
    "response_hours": "08:30 الی 21:00",
    "profile_fetched": true
  },
  "response_time_ms": 450
}
400
خطا

Invalid domain.

ساختار پاسخ:
{
  "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 (50,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 ریال، مبلغ مورد نیاز: 50,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
}