واجهة API لهوية الشركة

حوّل معرّف شركة Narwhal ثابتاً واحداً إلى هويتها لدى SEC وإدراجاتها ورمز الصناعة وأسمائها السابقة.

نقطة النهاية والطلب

متاح باستخدام مفتاح Narwhal API.

نقطة نهاية REST

GET /v1/companies/{company_id}

طلب

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/cmp_a1b2c3d4e5f678901234567890abcdef" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

يستخدم MCP companies_get مع المعلمات المقابلة أدناه. يعيد REST وMCP مخطط الاستجابة نفسه ويشتركان في حساب الحصة.

المعلمات

الاسم	مطلوب	النوع	المعنى
`company_id`	نعم	المسار · معرّف Narwhal غير قابل للتفسير	هوية الشركة الثابتة التي يعيدها البحث. ويظل رمز التداول وCIK اسمين بديلين، لا هوية دائمة للمسار.

الاستجابة

{
  "id": "cmp_a1b2c3d4e5f678901234567890abcdef",
  "name": "Apple Inc.",
  "cik": "0000320193",
  "entity_type": "operating",
  "sic": {
    "code": "3571",
    "description": "Electronic Computers"
  },
  "listings": [
    {
      "ticker": "AAPL",
      "exchange": "Nasdaq"
    }
  ],
  "former_names": [
    {
      "name": "APPLE COMPUTER INC",
      "from": "1994-01-26T05:00:00Z",
      "to": "2007-01-04T05:00:00Z"
    }
  ],
  "as_of": "2026-08-29T12:00:00Z"
}

حقل	النوع	مطلوب	المعنى
`id`	سلسلة نصية	نعم	معرّف شركة Narwhal ثابت وغير شفاف.
`name / cik`	سلاسل نصية	نعم	اسم الشركة الحالي وCIK الخاص بـSEC المكوّن من عشرة أرقام والمملوء بالأصفار.
`entity_type / sic`	سلسلة نصية أو كائن أو قيمة فارغة	نعم	تصنيف الكيان وتفاصيل SIC المقدمة من المصدر عند توفرها.
`listings`	مصفوفة	نعم	أسماء الرموز البديلة الحالية وأسماء البورصات التي قد تكون فارغة.
`former_names`	مصفوفة	نعم	الأسماء السابقة المنشورة من المصدر وطوابع الصلاحية القابلة للقيمة الفارغة.
`as_of`	طابع وقت UTC	نعم	وقت اللقطة للهوية المُعادة.

الأخطاء والحصة

400 invalid_query — الاستعلام أو التاريخ أو الاستمارة أو الحد أو المؤشر غير صالح.
401 invalid_api_key — مفتاح Bearer مفقود أو مرفوض.
404 company_not_found — معرّف الشركة غير معروف في الإصدار المقبول.
429 rate_limit_exceeded أو quota_exhausted — استُنفدت الحصة القصيرة أو الشهرية المشتركة.
503 companies_unavailable — Companies معطّلة، أو الحقوق غير نشطة، أو لا يمكن تقديم إصدار كامل مقبول.

لا تستهلك إخفاقات المصادقة والطلبات المرفوضة بسبب التقييد الحصة الشهرية. وتستخدم استدعاءات REST وMCP الناجحة مخصص الحساب نفسه.

نطاق الإصدار الأول

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

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