active Legal form UG (haftungsbeschränkt)

NCode UG (haftungsbeschränkt)

Apen ·HRB 216305 Oldenburg

Handelsregister API View JSON Collapse

{
    "name": "NCode UG (haftungsbeschränkt)",
    "status": "ACTIVE"
}

Live API

GEThandelsregister.ai/api/v1/fetch-organization

?q=951e7d293e3da9b0908ad3eadde8701d

&features=financial_kpi

&features=balance_sheet_accounts

&features=related_persons

&features=shareholders

&features=ubos

&features=history

&features=annual_financial_statements__html

curl -H 'X-API-KEY: YOUR_API_KEY' \
  "https://handelsregister.ai/api/v1/fetch-organization?q=951e7d293e3da9b0908ad3eadde8701d&features=financial_kpi&features=balance_sheet_accounts&features=related_persons&features=shareholders&features=ubos&features=history&features=annual_financial_statements__html"

# pip install handelsregister
from handelsregister import Handelsregister

client = Handelsregister(api_key="YOUR_API_KEY")  # or set HANDELSREGISTER_API_KEY
organization = client.fetch_organization(
    q="951e7d293e3da9b0908ad3eadde8701d",
    features=[
        "financial_kpi",
        "balance_sheet_accounts",
        "related_persons",
        "shareholders",
        "ubos",
        "history",
        "annual_financial_statements__html",
    ],
)
print(organization["name"])

// npm install handelsregister
import { Handelsregister } from 'handelsregister';

const client = new Handelsregister('YOUR_API_KEY'); // or set HANDELSREGISTER_API_KEY
const organization = await client.fetchOrganization({
  q: '951e7d293e3da9b0908ad3eadde8701d',
  features: [
    'financial_kpi',
    'balance_sheet_accounts',
    'related_persons',
    'shareholders',
    'ubos',
    'history',
    'annual_financial_statements__html',
  ],
});
console.log(organization.name);

// npm install handelsregister
const { Handelsregister } = require('handelsregister');

const client = new Handelsregister(process.env.HANDELSREGISTER_API_KEY);
(async () => {
  const organization = await client.fetchOrganization({
    q: '951e7d293e3da9b0908ad3eadde8701d',
    features: [
      'financial_kpi',
      'balance_sheet_accounts',
      'related_persons',
      'shareholders',
      'ubos',
      'history',
      'annual_financial_statements__html',
    ],
  });
  console.log(organization.name);
})();

JSON preview

{
    "entity_id": "951e7d293e3da9b0908ad3eadde8701d",
    "name": "NCode UG (haftungsbeschränkt)",
    "status": "ACTIVE",
    "legal_form": "UG (haftungsbeschränkt)",
    "registration_date": "2020-11-25T00:00:00+00:00",
    "purpose": "Entwicklung von Software",
    "address": {
        "street": "Herderstraße",
        "house_number": "11",
        "postal_code": "26689",
        "city": "Apen",
        "country": "DEU"
    },
    "registration": {
        "register_type": "HRB",
        "register_number": "216305",
        "court": "Oldenburg"
    }
}

"representation_scheme": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"capital": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"industry_classification": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"history": [ … ]

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"financial_kpi": [ … ]

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"related_persons": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"shareholders": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"ubos": { … }

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"balance_sheet_accounts": [ … ]

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

"annual_financial_statements__html": [ … ]

Register to retrieve the full JSON response in the playground. A monthly plan lets you expand every JSON field directly here.

Register for free

Base fields

entity_id string

Stable handelsregister.ai identifier (32-char hex string).

name string

Registered legal name of the entity.

status enum

ACTIVE, TERMINATED, DISSOLVED or INSOLVENT.

legal_form string

Legal form (GmbH, AG, KG, …) when available.

address object

Postal address with street, house_number, postal_code, city, county, state, country and coordinates.

registration object

Register record with court, register_type and register_number.

registration_date date

Initial entry into the commercial register (ISO date).

purpose string

Stated business purpose (Unternehmensgegenstand).

representation_scheme object

General representation scheme: { current: [...], history: [...] } with effective_from/effective_to per version.

capital object

Registered capital: { current, history }. current carries amount, currency and kind (STAMMKAPITAL, GRUNDKAPITAL, HAFTSUMME, GENEHMIGTES_KAPITAL, BEDINGTES_KAPITAL, VARIABLES_KAPITAL — open enum); each history entry has value, effective_from and effective_to (null = still in force). change_amount on a history entry is unsigned and does not always equal the difference between two consecutive amounts, so derive increases and decreases from the amounts. Partnerships and other entities without registered capital return current: null and an empty history.

contact_data object

website, phone_number and email when available.

industry_classification object

Industry codes per WZ2008 and WZ2025 with labels.

keywords array<string>

Keywords derived from the business purpose.

products_and_services array<string>

Product and service descriptions when available.

history array<object>

Chronological log of all register changes (name, seat, capital, representation, …).

features=financial_kpi

financial_kpi array<object>

Per fiscal year: revenue, employees, active_total (balance-sheet total), net_income, material_expenses, personnel_expenses.

features=balance_sheet_accounts

balance_sheet_accounts array<object>

Per fiscal year: hierarchical balance-sheet line items from the published annual statement.

features=profit_and_loss_account

profit_and_loss_account array<object>

Per fiscal year: hierarchical profit-and-loss line items.

features=related_persons

related_persons object

Authorized representatives: { current: [...], past: [...] } — managing directors, board members, signatories. Each person carries organization_representation_scheme and role_representation_scheme (current scheme + history).

features=shareholders

shareholders object

Shareholders: { total_capital, entries: [...], history: { current_as_of, past: [...] } }. Each entry carries shareholder, contribution, contribution_ratio and role; history.past delivers previous shareholder lists with an as_of date. total_capital, contribution and contribution_ratio may be null (e.g. for partnerships).

features=ubos

ubos object

Ultimate beneficial owners: { beneficial_owners, unresolved_beneficial_owners, coverage } as recorded in the transparency register.

features=shareholdings

shareholdings object

Stakes this entity holds in others: { holdings: { current: [...] }, summary }. Each holding links another organization by entity_id.

features=publications

publications array<object>

Official commercial-register publications (date, title, full text).

features=annual_financial_statements__html

annual_financial_statements__html array<object>

Published annual statements with document_html (rendered HTML), document_type, document_title, document_date, language and year.

Overview

Legal form: UG (haftungsbeschränkt)
Address: Herderstraße 11
26689 Apen
Commercial register: HRB 216305, Oldenburg
Registration date: November 25, 2020
Industry: Entwicklung und Programmierung von Anwendungssoftware
Programmierungstätigkeiten a. n. g.
Erbringung von sonstigen Dienstleistungen der Informationstechnologie
Registered capital: 1,000.00 EUR
Representation rules: Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch die Geschäftsführer gemeinsam vertreten.
Purpose: Entwicklung von Software

Financials

Total assets 2021

1.000 €

Balance sheet

2021

Assets 1,0 k

Current Assets 100,0 % 1,0 k
Fixed Assets 0,0 % 0
Prepaid Expenses 0,0 % 0
Deferred Tax Assets 0,0 % 0
Active Balancing Item from Asset Offset 0,0 % 0

Liabilities and Equity 1,0 k

Equity 100,0 % 1,0 k
Provisions 0,0 % 0
Liabilities 0,0 % 0
Accrued Expenses 0,0 % 0
Deferred Tax Liabilities 0,0 % 0

Full balance sheet line items with an API key Get API key →

Authorized representatives

Paul Ripken since 2021 Managing Director

Ownership & holdings

Shareholders

Paul Ripken 100.0 % 1k €

Ultimate beneficial owners (UBOs)

1 hold ≥ 25%

1 more beneficial owners · viewable with an API key Get API key →

History

2021
29.01.

Change of legal form

Unternehmergesellschaft (haftungsbeschränkt)
29.01.

Change of company name

NCode UG (haftungsbeschränkt)
29.01.

Member entry

Paul Ripken · Managing Director
29.01.

Change of seat

NCode UG (haftungsbeschränkt)
29.01.

Change of purpose

Entwicklung von Software
29.01.

Change of address

NCode UG (haftungsbeschränkt)
29.01.

Incorporation

NCode UG (haftungsbeschränkt)
29.01.

Change of bylaws

NCode UG (haftungsbeschränkt)

2 more events including all details Get API key →

Annual statements

Original published statements, ordered by fiscal year.

1 document

Fiscal year	Document	Published	Access
2021	Jahresabschluss	Published August 22, 2023	Via the API

All financial statements via the API

Register documents

Bring original register extracts and company documents into your application as PDF or XML.

GET/v1/fetch-document

View the document API

Current extract (AD) PDF
Chronological extract (CD) PDF
Structured content (SI, XML) XML
Shareholders list PDF
Articles of association PDF

Explore more companies

Handelsregister API · MCP

Company data in your AI chat

Ask about directors, ownership and financial figures. Our MCP server connects your assistant to the Handelsregister API.

MCP documentation

Connect your assistant

Open Connectors in Claude and add a custom connector.
Enter this server URL and add the connector:
https://mcp.handelsregister.ai/mcp
Connect with your handelsregister.ai account, then enable the connector in your chat via “+” → “Connectors”.

In ChatGPT on the web, open Settings → Apps and create a custom app. Developer mode must be enabled for your account.
Use “handelsregister” as the name, OAuth for authentication and this server URL:
https://mcp.handelsregister.ai/mcp
Sign in with your handelsregister.ai account, create the app and select it from the tools menu in your chat.

Run once in your terminal:

Terminal

claude mcp add --transport http handelsregister https://mcp.handelsregister.ai/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Replace YOUR_API_KEY with your handelsregister.ai API key.

Add this MCP server as a tool in your application:

Python

from openai import OpenAI

client = OpenAI()
response = client.responses.create(
    model="gpt-6-astra",
    input="Show me the directors, shareholders and latest available financial figures for NCode UG (haftungsbeschränkt). Include fiscal years and sources.\n\nentity_id: 951e7d293e3da9b0908ad3eadde8701d",
    tools=[{
        "type": "mcp",
        "server_label": "handelsregister",
        "server_url": "https://mcp.handelsregister.ai/mcp",
        "headers": {"X-API-Key": "YOUR_API_KEY"},
        "require_approval": "never",
    }],
)
print(response.output_text)

Replace YOUR_API_KEY with your handelsregister.ai API key.

Add this configuration to your MCP client:

JSON

{
  "mcpServers": {
    "handelsregister": {
      "url": "https://mcp.handelsregister.ai/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Replace YOUR_API_KEY with your handelsregister.ai API key.

Ask about this company

Once connected, ask your assistant this question:

Show me the directors, shareholders and latest available financial figures for NCode UG (haftungsbeschränkt). Include fiscal years and sources.

entity_id951e7d293e3da9b0908ad3eadde8701d

Copying failed. Please select the text and copy it manually.