# 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
Stable 32-char hex identifier. Pass straight into /fetch-organization as `q`.
name
string
Registered company name.
registration
object
Register record with court, register_type and register_number.
address
object
Postal address with street, house_number, postal_code, city, county, state, country and coordinates (latitude/longitude).
registration_date
date
Initial entry into the commercial register (ISO date).
purpose
string
Stated business purpose (Unternehmensgegenstand).
top-level
total
integer
Total result count for pagination.
meta.request_credit_cost
integer
Credits actually charged for this call.
meta.credits_remaining
integer
Account credit balance remaining after this call.