JavaScript
import Openregister from 'openregister';
const client = new Openregister({
apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});
const response = await client.document.getRealtimeV1({
company_id: 'company_id',
document_category: 'current_printout',
});
console.log(response.category);import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.document.get_realtime_v1(
company_id="company_id",
document_category="current_printout",
)
print(response.category)package main
import (
"context"
"fmt"
"github.com/oregister/openregister-go"
"github.com/oregister/openregister-go/option"
)
func main() {
client := openregister.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Document.GetRealtimeV1(context.TODO(), openregister.DocumentGetRealtimeV1Params{
CompanyID: "company_id",
DocumentCategory: openregister.DocumentGetRealtimeV1ParamsDocumentCategoryCurrentPrintout,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Category)
}
openregister document get-realtime-v1 \
--api-key 'My API Key' \
--company-id company_id \
--document-category current_printoutcurl --request GET \
--url https://api.openregister.de/v1/document \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openregister.de/v1/document",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.openregister.de/v1/document")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openregister.de/v1/document")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"url": "<string>",
"category": "current_printout",
"file_date": "<string>",
"file_name": "<string>"
}Document Realtime
GET
/
v1
/
document
JavaScript
import Openregister from 'openregister';
const client = new Openregister({
apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});
const response = await client.document.getRealtimeV1({
company_id: 'company_id',
document_category: 'current_printout',
});
console.log(response.category);import os
from openregister import Openregister
client = Openregister(
api_key=os.environ.get("OPENREGISTER_API_KEY"), # This is the default and can be omitted
)
response = client.document.get_realtime_v1(
company_id="company_id",
document_category="current_printout",
)
print(response.category)package main
import (
"context"
"fmt"
"github.com/oregister/openregister-go"
"github.com/oregister/openregister-go/option"
)
func main() {
client := openregister.NewClient(
option.WithAPIKey("My API Key"),
)
response, err := client.Document.GetRealtimeV1(context.TODO(), openregister.DocumentGetRealtimeV1Params{
CompanyID: "company_id",
DocumentCategory: openregister.DocumentGetRealtimeV1ParamsDocumentCategoryCurrentPrintout,
})
if err != nil {
panic(err.Error())
}
fmt.Printf("%+v\n", response.Category)
}
openregister document get-realtime-v1 \
--api-key 'My API Key' \
--company-id company_id \
--document-category current_printoutcurl --request GET \
--url https://api.openregister.de/v1/document \
--header 'Authorization: Bearer <token>'<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openregister.de/v1/document",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}HttpResponse<String> response = Unirest.get("https://api.openregister.de/v1/document")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openregister.de/v1/document")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"url": "<string>",
"category": "current_printout",
"file_date": "<string>",
"file_name": "<string>"
}Retrieve realtime documents for a company
Request official documents directly from the Handelsregister in real-time. This endpoint fetches documents on-demand from the official register, ensuring you always receive the most current version available. Cost: 10 creditsAvailable Document Types
You can retrieve several types of official documents by specifying thedocument_category parameter:
- current_printout (AD) - Current register extract showing the company’s current state (PDF)
- chronological_printout (CD) - Complete historical extract showing all changes (PDF)
- historical_printout (HD) - Historical snapshot from a previous point in time (PDF)
- shareholder_list (GV) - Official shareholder list (Gesellschafterliste) (PDF)
- articles_of_association (UT) - Company articles/bylaws (Satzung/Gesellschaftsvertrag) (PDF)
- structured_information (SI) - Structured company data (XML format)
Use Cases
Legal Documentation: Lawyers and notaries use this endpoint to obtain official, certified register extracts for transactions, litigation, or regulatory filings. The current printout (AD) is commonly required for contracts and due diligence. Compliance Archiving: Maintain audit trails by periodically downloading and archiving official documents. Keep historical snapshots for regulatory compliance and documentation requirements. Automated Verification: Integrate document retrieval into your workflows to automatically obtain proof of registration, current ownership, or corporate structure whenever needed for client onboarding or transaction processing.Authorizations
API Key Authentication Provide your API key as a Bearer token in the Authorization header.
Query Parameters
Available options:
current_printout, chronological_printout, historical_printout, structured_information, shareholder_list, articles_of_association Was this page helpful?
⌘I

