문서
어떤 문서가 어떤 형식으로 있는지.
fetch-document로 등기부의 공식 문서를 파일로 내려받아요. company_id에 회사의 entity_id를 넘기고 document_type을 고르세요. 전달된 문서마다 15 크레딧가 들어요.
문서 유형
문서 유형은 다섯 가지예요. document_type 값은 표와 똑같이, 대소문자까지 맞춰 쓰세요. 예시 요청은 Hetzner Online GmbH, Ansbach HRB 6089의 Aktueller Abdruck를 가져와요.
| document_type | 문서 | 형식 |
|---|---|---|
| AD | Aktueller Abdruck(현재 등본)현재 유효한 모든 등기. 전형적인 등기부 등본이에요. | |
| CD | Chronologischer Abdruck(연대순 등본)등기부를 전자로 관리하기 시작한 이후의, 말소된 것을 포함한 모든 등기를 시간순으로. | |
| SI | Strukturierter Registerinhalt(구조화 등기 내용)XJustiz 표준의 XML 등기 내용, 기계 처리에 적합해요. | XML |
| shareholders_list | Gesellschafterliste(주주 명부)GmbH가 등기부에 제출하는, 지분이 담긴 주주 명부. | |
| articles_of_association | Gesellschaftsvertrag 또는 Satzung(정관)회사를 규율하는 계약. GmbH에서는 Gesellschaftsvertrag, AG와 eG에서는 Satzung이라고 해요. |
curl -G "https://handelsregister.ai/api/v1/fetch-document" \ -H "x-api-key: YOUR_API_KEY" \ --data-urlencode 'company_id=94eb910fef13f94585c48c263fa446d4' \ --data-urlencode 'document_type=AD'
import requests response = requests.get( "https://handelsregister.ai/api/v1/fetch-document", headers={"x-api-key": "YOUR_API_KEY"}, params={ "company_id": "94eb910fef13f94585c48c263fa446d4", "document_type": "AD", }, ) data = response.json()
const url = new URL("https://handelsregister.ai/api/v1/fetch-document"); url.searchParams.append("company_id", "94eb910fef13f94585c48c263fa446d4"); url.searchParams.append("document_type", "AD"); const response = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const data = await response.json();
법적 형태별 문서
Aktueller Abdruck, Chronologischer Abdruck, Strukturierter Registerinhalt는 등기된 모든 회사에 있어요. 그 밖에 어떤 제출 문서가 있는지는 법적 형태에 따라 달라요.
| 법적 형태 | AD, CD, SI | 주주 명부 | 정관 |
|---|---|---|---|
| GmbH, UG | 있음 | 있음, 의무 | 있음, Gesellschaftsvertrag |
| AG, SE, KGaA | 있음 | 없음 | 있음, Satzung |
| eG | 있음 | 없음 | 있음, Satzung |
| KG, GmbH & Co. KG, OHG | 있음 | 없음 | 대개 없음 |
| PartG, PartG mbB | 있음 | 없음 | 대개 없음 |
| e.K. | 있음 | 없음 | 대개 없음 |
주주 명부는 GmbH와 UG에만 있어요. 다른 법적 형태와 없는 문서에는 API가 404로 응답하고 과금하지 않아요.
형식
응답은 JSON이 아니라 파일 자체예요. 유형은 Content-Type 헤더로, 파일 이름은 Content-Disposition 헤더로 알 수 있어요.
파일 이름에는 entity_id, 문서 유형, 조회 날짜가 들어 있어요. 예: document_94eb910fef13f94585c48c263fa446d4_AD_2026-11-01.pdf.
주주 명부와 정관은 스캔한 페이지인 경우가 많고, 일부는 텍스트 레이어가 없어요. 그때 텍스트를 얻으려면 OCR이 필요해요.
일부 문서는 등기부에서 TIFF 이미지로만 제공돼요. 이때 API는 415로 응답하고 과금하지 않아요.
Hetzner Online GmbH 예시에서 파일 크기는 다음과 같았어요: Aktueller Abdruck 약 35 KB, Strukturierter Registerinhalt 약 14 KB, Gesellschaftsvertrag 약 450 KB.
async=true로 백그라운드에서 문서를 가져오세요. 등기부가 제때 응답하지 않으면 Retry-After와 함께 504를 받아요. 이때는 과금되지 않아요.