POST
/
v2
/
companies
/
{kausateId}
/
report
Retrieve Company Report (Real-Time)
curl --request POST \
  --url https://api.openregisters.com/v2/companies/{kausateId}/report \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "customerReference": "<string>"
}'
{
"orderId": "report-D2601V_HRB******-DEHRSI-20240319143022",
"customerReference": "my-ref-123",
"status": "completed",
"requestTime": "2024-03-19T14:30:22.787045Z",
"responseTime": "2024-03-19T14:32:45.108791Z",
"result": {
"companyReport": {
"sources": {
"registrar": {
"type": "registrar",
"name": "Handelsregister Structured Information",
"jurisdictionCode": "DE",
"retrievalTime": "2024-03-19T14:30:49+0000",
"downloadUrl": "https://example.com/path/to/document.xml",
"fileHash": "abc123def456...",
"fileName": "2024-03-19T14-30-49+0000_abc123def456.xml"
}
},
"basicInformation": {
"type": "organization",
"legalName": "Example Solutions GmbH",
"legalForm": {
"original": "GmbH (exkl. gGmbH)",
"normalized": "Gesellschaft mit beschränkter Haftung",
"iso20275LegalFormCode": "2HBR"
},
"signatoryRules": {
"original": "General rule: Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten.; Specific rule: einzelvertretungsberechtigt; mit der Befugnis, im Namen der Gesellschaft mit sich im eigenen Namen oder als Vertreter eines Dritten Rechtsgeschäfte abzuschließen"
},
"capital": {
"currency": {
"amount": "25000.0",
"iso4217CurrencyCode": "EUR"
}
},
"identifiers": [
{
"value": "HRB ******",
"type": "de_registernumber_weak",
"description": "German commercial register number (weak identifier)"
},
{
"value": "D2601V_HRB******",
"type": "de_registernumber_full",
"description": "German commercial register number with court code"
}
],
"addresses": [
{
"type": "registered",
"source": "registrar",
"original": "München",
"normalized": {
"city": "München"
}
},
{
"type": "business",
"source": "registrar",
"original": "Musterstraße, 1, 10115, Berlin",
"normalized": {
"houseNumber": "1",
"road": "Musterstraße",
"postcode": "10115",
"city": "Berlin"
}
}
],
"activities": [
{
"scheme": "free_text",
"description": "Software development and consulting services",
"source": "registrar"
}
]
},
"relationships": {
"legalRepresentatives": [
{
"type": "person",
"person": {
"address": {
"type": "physical",
"source": "registrar",
"original": "Berlin",
"normalized": {
"city": "Berlin"
}
},
"dateOfBirth": {
"original": "1985-01-01",
"normalized": "1985-01-01"
},
"name": {
"firstName": "John",
"lastName": "Doe",
"fullName": "John Doe"
}
},
"role": {
"original": "Geschäftsführer(in)",
"englishTranslation": "Managing Director"
},
"source": "registrar"
}
]
}
}
}
}

Authorizations

X-API-Key
string
header
required

Sign up at OpenRegisters.com to get an API key

Path Parameters

kausateId
string
required

Company ID to order product for

Body

application/json

Request model for ordering a company report.

Response

200
application/json

Order successfully placed

Response model for product order.