# 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": "Nandlstadt",
"industry_code": "52.25.0",
"industry_scheme": "WZ2025"
},
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": "Nandlstadt",
"industry_code": "52.25.0",
"industry_scheme": "WZ2025"
},
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": "Nandlstadt",
"industry_code": "52.25.0",
"industry_scheme": "WZ2025"
},
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":"Nandlstadt","industry_code":"52.25.0","industry_scheme":"WZ2025"}'
{
"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
Stabiler 32-stelliger Hex-Bezeichner. Direkt als q an /fetch-organization übergebbar.
name
string
Eingetragener Firmenname.
registration
object
Registereintrag mit court, register_type und register_number.
address
object
Postanschrift mit street, house_number, postal_code, city, county, state, country und coordinates (latitude/longitude).
registration_date
date
Datum der Ersteintragung im Handelsregister (ISO).
purpose
string
Unternehmensgegenstand laut Eintragung.
top-level
total
integer
Gesamtanzahl der Treffer für die Pagination.
meta.request_credit_cost
integer
Tatsächlich für diesen Aufruf belasteter Credit-Betrag.
meta.credits_remaining
integer
Verbleibender Credit-Saldo des Accounts nach diesem Aufruf.