문서 다운로드

등기부 등본, 주주 명부, 정관을 파일로.

1

문서 유형 선택

document_type
document_type 문서 형식 대상
AD Aktueller Abdruck(현재 등본): 현재 유효한 모든 등기 PDF 등기된 모든 회사
CD Chronologischer Abdruck(연대순 등본): 모든 등기를 시간순으로 PDF 등기된 모든 회사
SI XJustiz 형식의 Strukturierter Registerinhalt(구조화 등기 내용), 기계 판독 가능 XML 등기된 모든 회사
shareholders_list Gesellschafterliste(주주 명부) PDF GmbH와 UG
articles_of_association Satzung 또는 Gesellschaftsvertrag(정관) PDF 자본회사와 협동조합
2

문서 가져오기

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" \
  --fail-with-body --max-time 120 \
  -o hetzner-ad.pdf
필드
필드 의미
Content-Type application/pdf, 구조화 등기 내용은 application/xml.
Content-Disposition entity_id, 유형, 문서를 등기부에서 가져온 날짜가 담긴 파일 이름.
X-Credits-Charged 요청 비용.
X-Credits-Remaining 요청 후 잔액.
1{2  "error": "Document fetch failed",3  "message": "Document not available for this company. It may not exist or may become available later.",4  "meta": {5    "request_credit_cost": 0,6    "credits_remaining": 1457  }8}
404 · 개인 상인의 주주 명부에 대한 예시 응답
API는 필요할 때 등기부에서 문서를 가져와요. 최대 2분이 걸릴 수 있어요. 클라이언트 타임아웃을 최소 120초로 설정하거나 문서를 백그라운드에서 가져오세요.
3

백그라운드에서 가져오기

curl -G "https://handelsregister.ai/api/v1/fetch-document" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode 'company_id=e3918174fb6c5d04e5e217e6ee4a6ffe' \
  --data-urlencode 'document_type=CD' \
  --data-urlencode 'async=true'
1{2  "status": "processing",3  "meta": {4    "message": "The document is being retrieved. Repeat this request after Retry-After seconds to receive it.",5    "retry_after": 20,6    "request_credit_cost": 0,7    "credits_remaining": 1458  }9}
202 · SAP SE의 Chronologischer Abdruck를 가져오는 동안의 예시 응답

비용과 한도

비용과 한도
항목 크레딧
전달된 문서 1건 15

한도: 분당 5 요청. 검색, 문서, Signals는 분당 60 요청의 한도를 공유해요.

Handelsregister에 지금 연결할 수 없거나 응답이 너무 느리면 Retry-After와 함께 HTTP 504를 받아요. API는 과금하지 않아요. 몇 분 뒤 다시 시도하세요.

자주 하는 실수

다음