active

SocialFlows GmbH GmbH

Hamburg ·HRB 181631 Hamburg ·socialflows.io

Part 1 / 2

Structured data

Parsed, typed and queryable directly through the API.

Overview

Legal form: GmbH
Address: Klärchenstraße 19
22299 Hamburg
Commercial register: HRB 181631, Hamburg
Registration date: March 16, 2023
Industry: Entwicklung und Programmierung von Anwendungssoftware
Erbringung von Beratungsleistungen auf dem Gebiet der Informationstechnologie
Vermittlung von Arbeitskräften
Purpose: Entwicklung und Vertrieb von Unternehmenssoftware im Bereich Bewerbermanagement und Recruiting.

Financials

No published key figures are available for this company.

Authorized representatives

Viet Pham Tuan since 2024 Managing Director

2 former representatives · viewable with an API key Get API key →

Ownership & holdings

Shareholders

SocialNatives GmbH DEU Amtsgericht Hamburg, HRB 162987 100.0 % 25k €

Ultimate beneficial owners (UBOs)

2 hold ≥ 25%

70.0 % identified 30.0 % unidentified

V****** S**** ≥25% 30.0 %
N****** N*** ≥25% 30.0 %

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

History

2024
18.12.

Member entry

Viet Pham Tuan · Managing Director
18.12.

Change of address

SocialFlows GmbH
18.12.

Exit of position

Luka Marvin Döllner · Managing Director
18.12.

Exit of position

Wolf Moog · Managing Director
2023
22.08.

Correction of personal data

L*** D****** · Managing Director
28.06.

Member entry

W*** M*** · Managing Director
28.06.

Change of purpose

Entwicklung und Vertrieb von Unternehmenssoftware im Bereich Bewerbermanagement und Recruiting.
28.06.

Change of seat

SocialFlows GmbH

8 more entries Get API key →

Part 2 / 2

Raw data & documents

Original filings, full-text markdown and PDFs — full content via the API.

Register documents

PDF documents straight from the court register — fetched on demand via the :code endpoint.

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

Unlock with API key Get API key →

Website content

Structured markdown rendering of the company's public website — perfect for enrichment and AI pipelines.

socialflows.io AI

Unlock with API key Get API key →

Live API

GEThandelsregister.ai/api/v1/fetch-organization

?q=a07b28e55c8bf73dfc4da3655aadf6ab

&features=related_persons

&features=shareholders

&features=ubos

&features=history

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

# pip install handelsregister
from handelsregister import Handelsregister

client = Handelsregister(api_key="YOUR_API_KEY")  # or set HANDELSREGISTER_API_KEY
organization = client.fetch_organization(
    q="a07b28e55c8bf73dfc4da3655aadf6ab",
    features=[
        "related_persons",
        "shareholders",
        "ubos",
        "history",
    ],
)
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: 'a07b28e55c8bf73dfc4da3655aadf6ab',
  features: [
    'related_persons',
    'shareholders',
    'ubos',
    'history',
  ],
});
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: 'a07b28e55c8bf73dfc4da3655aadf6ab',
    features: [
      'related_persons',
      'shareholders',
      'ubos',
      'history',
    ],
  });
  console.log(organization.name);
})();

{
    "entity_id": "<32-char hex>",
    "name": "<string>",
    "status": "<enum: ACTIVE | TERMINATED | DISSOLVED | INSOLVENT>",
    "legal_form": "<string>",
    "address": {
        "house_number": "<string>",
        "street": "<string>",
        "postal_code": "<string>",
        "city": "<string>",
        "county": "<string>",
        "state": "<string>",
        "country": "<ISO country>",
        "coordinates": {
            "latitude": "<float>",
            "longitude": "<float>"
        }
    },
    "registration": {
        "court": "<string>",
        "register_type": "<string>",
        "register_number": "<string>"
    },
    "registration_date": "<ISO date>",
    "purpose": "<string>",
    "keywords": [],
    "products_and_services": [],
    "contact_data": {
        "website": "<URL>",
        "phone_number": null,
        "email": null
    },
    "industry_classification": {
        "WZ2008": [],
        "WZ2025": [
            {
                "code": "<string>",
                "label": "<string>"
            }
        ]
    },
    "representation_scheme": {
        "current": [
            "<string>"
        ],
        "history": [
            {
                "value": [
                    "<string>"
                ],
                "effective_from": "<string>",
                "effective_to": null
            }
        ]
    },
    "related_persons": {
        "current": [
            {
                "entity_id": "<32-char hex>",
                "label": "<string>",
                "role": {
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "name": "<string>",
                "start_date": "<ISO date>",
                "end_date": null,
                "birth_date": null,
                "name_parts": {
                    "given": "<string>",
                    "family": "<string>",
                    "maiden": null,
                    "canonical_name": "<string>",
                    "previous_names": null
                },
                "location": {
                    "home": {
                        "city": "<string>"
                    }
                },
                "organization_representation_scheme": {
                    "current": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": null
                        }
                    ]
                },
                "role_representation_scheme": {
                    "current": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": null
                        }
                    ]
                }
            }
        ],
        "past": [
            {
                "entity_id": "<32-char hex>",
                "label": "<string>",
                "role": {
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                },
                "name": "<string>",
                "start_date": "<ISO date>",
                "end_date": "<ISO date>",
                "birth_date": null,
                "name_parts": {
                    "given": "<string>",
                    "family": "<string>",
                    "maiden": null,
                    "canonical_name": "<string>",
                    "previous_names": null
                },
                "location": {
                    "home": {
                        "city": "<string>"
                    }
                },
                "organization_representation_scheme": {
                    "latest": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": null
                        }
                    ]
                },
                "role_representation_scheme": {
                    "latest": [
                        "<string>"
                    ],
                    "history": [
                        {
                            "value": [
                                "<string>"
                            ],
                            "effective_from": "<string>",
                            "effective_to": "<string>"
                        }
                    ]
                }
            }
        ]
    },
    "profit_and_loss_account": [],
    "shareholdings": null,
    "ubos": {
        "beneficial_owners": [
            {
                "person": {
                    "entity_id": "<32-char hex>",
                    "name": "<string>",
                    "birth_date": null,
                    "name_parts": {
                        "given": "<string>",
                        "family": "<string>",
                        "canonical_name": "<string>"
                    },
                    "location": {
                        "home": {
                            "city": "<string>",
                            "county": "<string>",
                            "state": "<string>",
                            "country": "<ISO country>"
                        }
                    }
                },
                "ownership_percentage": "<float>",
                "paths": [
                    {
                        "percentage": "<float>",
                        "via": [
                            {
                                "depth": "<int>",
                                "name": "<string>",
                                "entity_id": "<32-char hex>",
                                "step_percentage": "<float>"
                            }
                        ]
                    }
                ]
            }
        ],
        "unresolved_beneficial_owners": [
            {
                "reason": "<string>",
                "entity_id": "<32-char hex>",
                "name": "<string>",
                "legal_form": "<string>",
                "address": {
                    "house_number": "<string>",
                    "street": "<string>",
                    "postal_code": "<string>",
                    "city": "<string>",
                    "county": "<string>",
                    "state": "<string>",
                    "country": "<ISO country>",
                    "coordinates": {
                        "latitude": "<float>",
                        "longitude": "<float>"
                    }
                },
                "registration": {
                    "court": "<string>",
                    "register_type": "<string>",
                    "register_number": "<string>"
                },
                "ownership_percentage": "<float>",
                "via": [
                    {
                        "depth": "<int>",
                        "name": "<string>",
                        "entity_id": "<32-char hex>",
                        "step_percentage": "<float>"
                    }
                ]
            }
        ],
        "coverage": {
            "resolved_percentage": "<float>",
            "unresolved_percentage": "<float>"
        }
    },
    "balance_sheet_accounts": [],
    "financial_kpi": [],
    "shareholders": {
        "total_capital": {
            "amount": "<float>",
            "currency": "<ISO currency>"
        },
        "entries": [
            {
                "shareholder": {
                    "entity_id": "<32-char hex>",
                    "entity_name": "<string>",
                    "address": "<string>",
                    "country_code": "<ISO country>",
                    "registration_reference": "<string>"
                },
                "contribution": {
                    "amount": "<float>",
                    "currency": "<ISO currency>"
                },
                "contribution_ratio": "<float>",
                "role": {
                    "label": "<string>",
                    "en": {
                        "long": "<string>",
                        "short": "<string>"
                    },
                    "de": {
                        "long": "<string>",
                        "short": "<string>"
                    }
                }
            }
        ],
        "history": {
            "redacted": "<bool>"
        }
    },
    "annual_financial_statements__html": [],
    "history": [
        {
            "entity_type": "<string>",
            "name": {
                "de": "<string>",
                "en": "<string>"
            },
            "description": {
                "short": {
                    "de": "<string>",
                    "en": "<string>"
                }
            },
            "start_date": "<ISO date>",
            "details": {
                "value": {
                    "role": {
                        "name": "<string>",
                        "original_name_source": "<string>",
                        "representation_scheme": [
                            "<string>"
                        ]
                    }
                },
                "linked_entities": {
                    "person": {
                        "name": {
                            "given": "<string>",
                            "family": "<string>"
                        }
                    },
                    "organization": {
                        "name": "<string>"
                    }
                }
            }
        }
    ]
}

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

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.

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.

Profile · Financials · People · Documents

Structured data and full text — per company

From annual statements as HTML to UBO lists: enable each field individually via the features parameter. One API, all data.

Key figures Revenue, employee count, total assets, net income — per fiscal year.
Authorized representatives Current and former managing directors, board members, signatories — with roles and date ranges.
Publications Official commercial register publications including date and full text.
Gesellschafter Current shareholder structure with stakes and contributions.
Wirtschaftlich Berechtigte (UBOs) Ultimate beneficial owners as recorded in the German transparency register.
Beteiligungen Stakes this company holds in other entities.
Bilanz Full balance sheet line items from published annual statements.
Gewinn- und Verlustrechnung P&L line items per fiscal year.
Jahresabschlüsse (HTML) Published annual financial statements rendered as HTML.
Insolvenzbekanntmachungen Notices from the official insolvency registers.
News Recent mentions of the company from external news sources.

Unlock every field with an API key Get API key →

Code · AI agents · No-code · Workflows

Plug into any stack

Whether you're building a classical API integration, an AI agent, or a no-code workflow — this data slots in.

REST API Plain GET request with an X-API-KEY header. Works with any HTTP client. Python Works with requests, httpx, or your library of choice. Node.js Standard fetch or axios — no extra SDK required. MCP Server Plug directly into Claude, Cursor, or any MCP-capable AI client. n8n Drop-in custom node for n8n workflow automations. Webhook Callable from Zapier, Make, or any webhook platform.

Use this data in your app

Grab an API key and pull this structured commercial register data straight from your application — no scraping, no PDFs.

Get API key