# 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": "Kescheid" },
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": "Kescheid" },
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": "Kescheid" },
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":"Kescheid"}'
{
"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자리 16진수 식별자예요. /fetch-organization에 `q`로 바로 전달할 수 있어요.
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
이 호출 후 남은 계정 크레딧 잔액.