מספר חברה (ח.פ.) או שם, בעברית או באנגלית, ובקריאה אחת מתקבלים השם הרשום, הצורה המשפטית, הסטטוס והכתובת של החברה מרשות התאגידים, בפורמט JSON אחד שזהה לכל מדינה אחרת ב-API.
בדיקת חברה לפי ח.פ. עונה על שלוש שאלות לפני שנכנסים איתה לעסקה: האם המספר שייך לחברה שקיימת, האם החברה פעילה או נמצאת בהליך (פירוק, כינוס נכסים, מחיקה), ומה שמה וכתובתה הרשומים. המקור הרשמי הוא רשם החברות ברשות התאגידים שבמשרד המשפטים. Prometiam מגישה את אותם נתונים כ-API: שולחים ח.פ. או שם ומקבלים רשומה בפורמט JSON, באותו מבנה שמתקבל מכל אחת מ-27 המדינות שהשירות מכסה. בעמוד הזה מוסבר איך זה עובד, מה מקבלים ומה לא.
ח.פ. הוא מספר בן 9 ספרות שמתחיל ב-51 (בדרך כלל חברה פרטית), ב-52 (בדרך כלל חברה ציבורית) או ב-56, למשל 520013954 לטבע תעשיות פרמצבטיות ו-520042821 לצ'ק פוינט טכנולוגיות תוכנה. הספרה האחרונה היא ספרת ביקורת, אך היא ייעוצית בלבד: מספר רשום שאינו עומד בבדיקה עדיין נשלף, והממשק רק מציין זאת. מספר בן 9 ספרות שאינו מתחיל ב-51, 52 או 56, כמו מספר זהות, נדחה בשגיאת 400. כתיבה עם מקפים (51-000001-1) או עם הקידומת "ח.פ." מתקבלת.
שלוש דרכים, כולן באותה נקודת קצה, GET /companies/search עם country=IL:
company_number=520013954 מחזיר את הרשומה המדויקת.name= עם השם בקידוד URL. החיפוש מנורמל וחלקי, ולכן אפשר להפעיל אותו תוך כדי הקלדה בטופס, קריאה אחת לכל הקשה.check point, כשהרשם מחזיק שם באנגלית לחברה.curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=IL&company_number=520013954' \ -H 'Authorization: Bearer rk_live_...' # לפי שם בעברית (טבע, בקידוד URL) curl 'https://api.prometiam.com/functions/v1/risk-api/companies/search?country=IL&name=%D7%98%D7%91%D7%A2' \ -H 'Authorization: Bearer rk_live_...'
לח.פ. מתקבל אובייקט חברה אחד; לשם מתקבלת רשימה מדורגת לפי מידת ההתאמה. ה-id שבתשובה משמש ל-GET /companies/{id} לרשומה המלאה. לרשימת חברות בבת אחת קיים POST /companies/lookup עד 100 פריטים בקריאה. כך בודקים בקוד ובקצרה:
import requests
BASE = "https://api.prometiam.com/functions/v1/risk-api"
H = {"Authorization": "Bearer rk_live_..."}
r = requests.get(f"{BASE}/companies/search", headers=H,
params={"country": "IL", "company_number": "520013954"})
for c in r.json().get("data", []):
print(c["company_name"], c["status"], c["city"])
| שדה | מה הוא מכיל |
|---|---|
company_name, company_number | שם החברה בעברית כפי שהוא רשום, והח.פ. |
registry_details | השם באנגלית כשהרשם מחזיק אחד, האם האחריות מוגבלת, ודגלים לחברה ממשלתית ולחברה לתועלת הציבור |
legal_form, legal_form_full | חברה פרטית, ציבורית, חברת אג"ח או חברה זרה |
status, local_status | המצב לפי הרשם בערך אחיד: פעילה, בפירוק מרצון, בפירוק בצו בית משפט, בכינוס נכסים, התמזגה או נמחקה |
address, postal_code, city, region | הכתובת הרשומה, המיקוד והעיר; region מכיל את המחוז |
founding_date | תאריך ההתאגדות |
לישראל יש גם אירועי שינוי ברשם (שינוי שם, סטטוס, צורה משפטית וכתובת רשומה) ומעקב: עם POST /monitor מוסיפים חברה למעקב, וה-webhook מדווח על שינוי סטטוס, פירוק ואירועי רשם. האירועים מתוארכים לפי המועד שבו השינוי מופיע לראשונה בנתוני הרשם, ואין אירועים מלפני הטעינה הראשונה באוקטובר 2026. הנתונים מתעדכנים בכל יום עבודה.
Contains information from the Israeli Corporations Authority, Ministry of Justice, via data.gov.il (used under the data.gov.il terms of use). Adapted by Prometiam; not an official register extract.
Starter עולה 9.99 אירו לחודש (1,000 קרדיטים), Professional 29.99 אירו (10,000 קרדיטים), Scale 99.99 אירו (50,000 קרדיטים), ו-Enterprise במחיר מותאם. רשומת חברה עולה קרדיט אחד, כלומר כ-0.01 אירו ב-Starter וכ-0.002 אירו ב-Scale; שגיאות אינן עולות כלום. הניסיון נמשך 14 יום וכולל 500 קרדיטים; נדרש כרטיס אשראי, ובמהלכו לא מתבצע חיוב, ובסיומו תחול חבילת Starter אלא אם תבטלו. המחירים פומביים וללא שיחת מכירה. פרטים ב-עמוד התמחור.
התחילו ניסיון חינם ל-14 יום · תיעוד ה-API
הניסיון נמשך 14 יום וכולל 500 קרדיטים. נדרש כרטיס אשראי, ובמהלך הניסיון לא מתבצע חיוב; לאחר מכן תחול חבילת Starter (9.99 אירו לחודש), אלא אם תבטלו.