# pip install handelsregister
from handelsregister import Handelsregister
client = Handelsregister(api_key="YOUR_API_KEY") # or set HANDELSREGISTER_API_KEY
page = client.search_organizations(
filters={ "city": "Holzsußra" },
limit=20,
skip=0,
)
print(page["total"])
for item in page["results"]:
print(item["name"], item["registration"]["register_number"])
// npm install handelsregister
import { Handelsregister } from 'handelsregister';
const client = new Handelsregister('YOUR_API_KEY'); // or set HANDELSREGISTER_API_KEY
const page = await client.searchOrganizations({
filters: { "city": "Holzsußra" },
limit: 20,
skip: 0,
});
console.log(page.total);
for (const item of page.results) {
console.log(item.name, item.registration.register_number);
}
// npm install handelsregister
const { Handelsregister } = require('handelsregister');
const client = new Handelsregister(process.env.HANDELSREGISTER_API_KEY);
(async () => {
const page = await client.searchOrganizations({
filters: { "city": "Holzsußra" },
limit: 20,
skip: 0,
});
console.log(page.total);
for (const item of page.results) {
console.log(item.name, item.registration.register_number);
}
})();
curl 'https://handelsregister.ai/api/v1/search-organizations?limit=20' \
-H 'x-api-key: YOUR_API_KEY' \
-G --data-urlencode 'filters={"city":"Holzsußra"}'
{
"results": [
{
"entity_id": "<32-char hex>",
"name": "<string>",
"registration": {
"court": "<string>",
"register_type": "<string>",
"register_number": "<string>"
},
"address": {
"house_number": "<string>",
"street": "<string>",
"postal_code": "<string>",
"city": "<string>",
"county": "<string>",
"state": "<string>",
"country": "<ISO country>",
"coordinates": {
"latitude": "<float>",
"longitude": "<float>"
}
},
"registration_date": "<ISO date>",
"purpose": "<string>"
}
],
"total": "<int>",
"meta": {
"request_credit_cost": "<int>",
"credits_remaining": "<int>"
}
}
results[]
entity_id
string
معرّف سداسي عشري ثابت من 32 حرفًا. مرّره مباشرةً إلى /fetch-organization كـ `q`.
name
string
اسم الشركة المسجّل.
registration
object
قيد السجل مع court وregister_type وregister_number.
address
object
العنوان البريدي مع street وhouse_number وpostal_code وcity وcounty وstate وcountry والإحداثيات (latitude/longitude).
registration_date
date
القيد الأول في السجل التجاري (تاريخ ISO).
purpose
string
غرض الشركة المعلن (Unternehmensgegenstand).
top-level
total
integer
إجمالي عدد النتائج لترقيم الصفحات.
meta.request_credit_cost
integer
الأرصدة المحتسبة فعليًا لهذا الاستدعاء.
meta.credits_remaining
integer
رصيد الحساب المتبقي بعد هذا الاستدعاء.