GET
/
v0
/
company
/
{company_id}
JavaScript
import Openregister from 'openregister';

const client = new Openregister({
  apiKey: process.env['OPENREGISTER_API_KEY'], // This is the default and can be omitted
});

const company = await client.company.retrieve('company_id');

console.log(company.id);
{
  "id": "<string>",
  "register": {
    "company_id": "<string>",
    "register_number": "<string>",
    "register_type": "HRB",
    "register_court": "<string>",
    "start_date": "<string>"
  },
  "registers": [
    {
      "company_id": "<string>",
      "register_number": "<string>",
      "register_type": "HRB",
      "register_court": "<string>",
      "start_date": "<string>"
    }
  ],
  "status": "active",
  "name": {
    "name": "<string>",
    "legal_form": "ag",
    "start_date": "<string>"
  },
  "names": [
    {
      "name": "<string>",
      "legal_form": "ag",
      "start_date": "<string>"
    }
  ],
  "address": {
    "street": "<string>",
    "city": "<string>",
    "postal_code": "<string>",
    "country": "<string>",
    "extra": "<string>",
    "start_date": "<string>",
    "formatted_value": "<string>"
  },
  "addresses": [
    {
      "street": "<string>",
      "city": "<string>",
      "postal_code": "<string>",
      "country": "<string>",
      "extra": "<string>",
      "start_date": "<string>",
      "formatted_value": "<string>"
    }
  ],
  "purpose": {
    "purpose": "<string>",
    "start_date": "<string>"
  },
  "purposes": [
    {
      "purpose": "<string>",
      "start_date": "<string>"
    }
  ],
  "capital": {
    "amount": 123,
    "currency": "EUR",
    "start_date": "<string>"
  },
  "capitals": [
    {
      "amount": 123,
      "currency": "EUR",
      "start_date": "<string>"
    }
  ],
  "representation": [
    {
      "id": "<string>",
      "name": "<string>",
      "type": "natural_person",
      "role": "DIRECTOR",
      "start_date": "<string>",
      "end_date": "<string>",
      "city": "<string>",
      "country": "<string>",
      "first_name": "<string>",
      "last_name": "<string>",
      "date_of_birth": "<string>"
    }
  ],
  "financials": {
    "reports": [
      {
        "id": "<string>",
        "name": "<string>",
        "published_at": "<string>"
      }
    ],
    "indicators": [
      {
        "report_id": "<string>",
        "type": "balance_sheet_total",
        "value": 123,
        "date": "<string>"
      }
    ]
  },
  "legal_form": "ag",
  "documents": [
    {
      "id": "<string>",
      "type": "articles_of_association",
      "date": "<string>",
      "latest": true
    }
  ],
  "incorporated_at": "<string>",
  "terminated_at": "<string>"
}

​
Get company information

Retrieve detailed information about a company using its unique ID. The response includes company registration details, current status, name, address, business purpose, capital, legal representatives, and legal form. You can optionally request historical data, financial information, and document metadata by using the appropriate query parameters.

Authorizations

​
Authorization
string
header
required

API Key Authentication Provide your API key as a Bearer token in the Authorization header.

Path Parameters

​
company_id
string
required

Unique company identifier. Example: DE-HRB-F1103-267645

Query Parameters

​
history
boolean
default:true

Include historical company data when set to true. This returns past names, addresses, and other changed information.

​
financials
boolean
default:true

Include financial data when set to true. Provides access to financial reports and key financial indicators.

​
documents
boolean
default:true

Include document metadata when set to true. Lists available official documents related to the company.

Response

200
application/json

Successfully retrieved company data

The response is of type object.