الهوية والتحقق

API التحقق من رقم VAT

تحقق من أرقام VAT لعملائك عند الدفع أو التسجيل. تُفحص أرقام الاتحاد الأوروبي وأيرلندا الشمالية مباشرة عبر سجل VAT الأوروبي، والأرقام النرويجية عبر سجل الأعمال النرويجي، مع الاسم والعنوان المسجلين في الدول التي تفصح عنهما.

عرض الوثائق جرّب الأداة المجانية استكشف جميع واجهات API

نقاط النهاية نشط

GET /v1/vat/validate

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

مثال الرد 200 OK

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registe
...

طلب مثال GET /v1/vat/validate

الميزات الرئيسية 4

الأسئلة الشائعة 4

رموز حالة HTTP 200 / 400 / 401 / 402 / 429

Category الهوية والتحقق

نقاط النهاية 1

الميزات الرئيسية 4

الأسئلة الشائعة 4

يستخدمه أشخاص في هذه الشركات

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

10,000 حصة مجانية

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

ما الذي تساعدك هذه الواجهة على إطلاقه

استخدم هذه الصفحة كملخص إنتاج: نقاط النهاية، الأمثلة، شكل الاستجابة، وأجزاء سير العمل اللازمة لربط DomScan بمنتجك.

سير عمل المنتج

ادمج فحوصات النطاقات، معلومات DNS، إشارات المخاطر أو الإثراء داخل الإعداد، البحث والأدوات الداخلية.

أتمتة المحللين

استبدل عمليات البحث اليدوية المتكررة بمهام مجدولة وتنبيهات وخطوات تحقيق قابلة للإعادة.

بيانات JSON نظيفة

استخدم حقولًا متوقعة، رموز حالة موثقة وتكاليف ائتمان بدلًا من كشط صفحات المزودين.

أدوات الذكاء الاصطناعي والعمليات

زوّد الوكلاء ولوحات المعلومات ودفاتر SOAR وCRMs عبر OpenAPI أو SDK أو Postman أو MCP.

سير عمل التكامل

مسار بسيط من أول طلب إلى استخدام إنتاجي قابل للتكرار.

المصادقة مرة واحدة

أرسل مفتاح API مع الترويسة الموثقة وحافظ على اتساق الطلبات عبر الخدمات.

الاستعلام باستخدام الأمثلة

ابدأ من أمثلة curl وHTTP ثم اربط المعلمات بكود تطبيقك.

التشغيل والمراقبة

استخدم رموز الحالة وتكاليف الاعتمادات وحقول الاستجابة لبناء إعادة المحاولة والسجلات والتنبيهات.

عدة المطور

انتقل من هذه الصفحة إلى وثائق قابلة للقراءة آليًا، مجموعات طلبات، SDKs أو أدوات للوكلاء.

مخطط OpenAPI

أنشئ عملاء أو افحص شكل كل طلب واستجابة.

مجموعة Postman

استورد طلبات جاهزة للاختبار اليدوي وتسليم الفريق.

SDKs وCLI

استخدم حزمًا مصانة وسير عمل سطر الأوامر بدل كتابة boilerplate.

تكامل MCP

اعرض ذكاء النطاقات لوكلاء الذكاء الاصطناعي وسير عمل المساعدين الداخليين.

خريطة المعلمات والاستجابة

راجع المدخلات وحقول الإخراج ورموز الحالة قبل توصيل نقطة النهاية بعميلك.

معلمات الطلب

المعامل

vatcountryrequester

حقول الاستجابة

مثال الرد

vat_numbercountry_codestatusvalidreasonformat_validchecksumregistered_nameregistered_addressname_discloseddetailsdetails.vat_registered

تغطية الحالة

رموز حالة HTTP

200400401402429

نقاط النهاية

GET /v1/vat/validate

الرصيد: 1المصادقة: المصادقة مطلوبة

إشارات ثقة قبل التكامل

توفر الوثائق الواضحة والطلبات الموثقة وتفاصيل الاعتمادية المرئية طريقة أسهل لتقييم DomScan قبل الإطلاق.

مباشر حالة الخدمة

تحقق من حالة الخدمة المباشرة واستجابات الفشل الموثقة قبل التكامل.

OpenAPI ملفات API

روابط OpenAPI وSwagger وPostman وCLI وSDK وMCP متاحة بنقرة واحدة.

مفاتيح API وصول محمي

تستخدم نقاط النهاية الموثقة مفاتيح API مع تكاليف رصيد واضحة قبل الاستدعاء.

10,000 حصة مجانية

ابدأ مع 10,000 رصيد شهري وقم بالترقية فقط عند نمو الاستخدام.

الميزات الرئيسية

فحوصات مباشرة للسجلات

تأتي الصلاحية من السجل الرسمي لحظة الطلب، وليس من قائمة مخزنة مؤقتاً ولا من فحص الصيغة وحده.

إثبات لعملية التحقق

أرسل رقم VAT الأوروبي الخاص بك كطالب لتحصل على رقم استشارة يمكنك الاحتفاظ به كدليل لإصدار الفواتير بآلية الاحتساب العكسي.

الصيغة وأرقام التحقق أولاً

تُرفض الأرقام المشوهة دون استدعاء السجل، وتُعرض أرقام التحقق لكل دولة مدعومة.

غير معروف، وليس غير صالح

عندما يكون السجل الوطني متوقفاً أو مشغولاً، تكون النتيجة غير معروفة مع بيان السبب، ولا تُحتسب رسوم على الطلب.

طلب مثال

GET /v1/vat/validate?vat=NO923609016MVA bash

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/vat/validate?vat=NO923609016MVA"

مثال الرد

200 OK json

{
  "vat_number": "NO923609016MVA",
  "country_code": "NO",
  "status": "valid",
  "valid": true,
  "reason": "active_vat_registration",
  "format_valid": true,
  "checksum": "valid",
  "registered_name": "EQUINOR ASA",
  "registered_address": "Forusbeen 50, 4035 STAVANGER, Norge",
  "name_disclosed": true,
  "details": { "vat_registered": true, "vat_registered_since": "1989-07-01", "bankrupt": false }
}

الأسئلة الشائعة

ما الدول التي يغطيها؟

تُفحص مباشرة دول الاتحاد الأوروبي السبع والعشرون وأيرلندا الشمالية والنرويج. أما الأرقام البريطانية والسويسرية والأسترالية فيُفحص شكلها وأرقام التحقق فيها، لأن تلك السجلات لا توفر فحصاً عاماً مجانياً.

لماذا اسم المنشأة غير موجود؟

بعض الدول، مثل ألمانيا وإسبانيا، لا تفصح عن الأسماء والعناوين عبر السجل الأوروبي. عندئذٍ تضبط النتيجة name_disclosed على false.

ماذا تعني النتيجة غير معروفة؟

تعذر على السجل تقديم إجابة: لأنه غير متاح أو مشغول أو بطيء جداً. أعد المحاولة لاحقاً. وتُسترد رسوم النتائج غير المعروفة.

كم عدد الأرصدة التي يكلفها؟

رصيد واحد لكل عملية تحقق. ولا تُحتسب رسوم على عمليات التحقق التي تنتهي بنتيجة غير معروفة.

الأدوات والموارد ذات الصلة

رموز حالة HTTP

هذه هي رموز حالة HTTP التي ينبغي التعامل معها، لتتمكن من التمييز بين الاستجابات الناجحة ومشكلات المصادقة والأرصدة وحدود المعدل والبيانات المفقودة وأعطال المصدر.

OK 200

نجح الطلب

طلب غير صالح 400

معلمات غير صالحة

غير مصرح 401

مفتاح API أو الجلسة مفقود أو غير صالح.

الدفع مطلوب 402

لا توجد أرصدة كافية لتنفيذ هذا الطلب.

طلبات كثيرة جداً 429

تم تجاوز حد المعدل

تحقق من رقم VAT

ابدأ مجاناً عرض الوثائق جرّب الأداة المجانية