active Legal form GmbH

RAYY GmbH

Köln ·HRB 97279 Köln ·studiorayy.com

Handelsregister API View JSON Collapse

{
    "name": "RAYY GmbH",
    "status": "ACTIVE"
}

Live API

GEThandelsregister.ai/api/v1/fetch-organization

?q=f59f6db0173e44ee9a83a7fe71c01a06

&features=financial_kpi

&features=balance_sheet_accounts

&features=related_persons

&features=shareholders

&features=ubos

&features=shareholdings

&features=history

&features=annual_financial_statements__html

curl -H 'X-API-KEY: YOUR_API_KEY' \
  "https://handelsregister.ai/api/v1/fetch-organization?q=f59f6db0173e44ee9a83a7fe71c01a06&features=financial_kpi&features=balance_sheet_accounts&features=related_persons&features=shareholders&features=ubos&features=shareholdings&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="f59f6db0173e44ee9a83a7fe71c01a06",
    features=[
        "financial_kpi",
        "balance_sheet_accounts",
        "related_persons",
        "shareholders",
        "ubos",
        "shareholdings",
        "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: 'f59f6db0173e44ee9a83a7fe71c01a06',
  features: [
    'financial_kpi',
    'balance_sheet_accounts',
    'related_persons',
    'shareholders',
    'ubos',
    'shareholdings',
    '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: 'f59f6db0173e44ee9a83a7fe71c01a06',
    features: [
      'financial_kpi',
      'balance_sheet_accounts',
      'related_persons',
      'shareholders',
      'ubos',
      'shareholdings',
      'history',
      'annual_financial_statements__html',
    ],
  });
  console.log(organization.name);
})();

JSON preview

{
    "entity_id": "f59f6db0173e44ee9a83a7fe71c01a06",
    "name": "RAYY GmbH",
    "status": "ACTIVE",
    "legal_form": "GmbH",
    "registration_date": "2019-01-23T00:00:00+00:00",
    "address": {
        "street": "Schönsteinstr.",
        "house_number": "12a",
        "postal_code": "50825",
        "city": "Köln",
        "country": "DEU"
    },
    "registration": {
        "register_type": "HRB",
        "register_number": "97279",
        "court": "Köln"
    }
}

"purpose": "…"

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

Register for free

"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

"contact_data": { … }

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

"keywords": [ … ]

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

Register for free

"products_and_services": [ … ]

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

"shareholdings": { … }

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: GmbH
Address: Schönsteinstr. 12a
50825 Köln
Commercial register: HRB 97279, Köln
Registration date: January 23, 2019
Industry: Beteiligungsgesellschaften
Messe-, Kongress- und Business-Event-Veranstalter
Erbringung von sonstigen Dienstleistungen für Veranstaltungen nicht künstlerischer Art
Registered capital: 25,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 zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten.
Purpose: die Inszenierung im Bereich der Live Kommunikation mit Showproduktionen, interaktive Installationen und digitale Messeexponate, sowie sämtliche damit zusammenhängenden und den Gesellschaftszweck fördernden Geschäfte.

Financials

Employees 2023

1

Total assets 2023

183.944 €

Net income 2023

41.685 €

3 previous years · values unlocked with an API key Get API key →

Balance sheet

2023

Assets 183,9 k

Current Assets 88,1 % 162,1 k
Fixed Assets 11,9 % 21,9 k

Liabilities and Equity 183,9 k

Equity 80,0 % 147,2 k
Provisions 10,9 % 20,0 k
Liabilities 9,1 % 16,8 k

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

Balance sheet data available for 3 earlier fiscal years.

Authorized representatives

Jens-Henrik Heinen since 2019 Managing Director

Ownership & holdings

Shareholders

Jens-Henrik Heinen 100.0 % 25k €

Ultimate beneficial owners (UBOs)

1 hold ≥ 25%

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

Holds shares in

Skillzcard GmbH Köln, DEU 33.3 %

History

2020
17.11.

Change of address

RAYY GmbH
07.07.

Change of address

RAYY GmbH
2019
25.02.

Change of purpose

die Inszenierung im Bereich der Live Kommunikation mit Showproduktionen, interaktive Installationen und digitale Messeexponate, sowie sämtliche damit zusammenhängenden und den Gesellschaftszweck fördernden Geschäfte.
25.02.

Change of company name

RAYY GmbH
25.02.

Incorporation

RAYY GmbH
25.02.

Change of share capital

RAYY GmbH
25.02.

Change of seat

RAYY GmbH
25.02.

Member entry

Jens-Henrik Heinen · Managing Director

4 more entries Get API key →

Annual statements

Original published statements, ordered by fiscal year.

4 documents

Fiscal year	Document	Published	Access
2023	Jahresabschluss	Published January 24, 2025	Via the API
2022	Jahresabschluss	Published February 9, 2024	Read full text
2021	Jahresabschluss	Published March 1, 2023	Via the API
2020	Jahresabschluss	Published July 12, 2021	Via the API

All financial statements via the API

2022 Jahresabschluss Full text

RAYY GmbH

Köln

Jahresabschluss zum Geschäftsjahr vom 01.01.2022 bis zum 31.12.2022

Bilanz

Aktiva
	31.12.2022 EUR	31.12.2021 EUR
A. Anlagevermögen	35.124,00	3.893,00
I. Sachanlagen	22.624,00	3.893,00
II. Finanzanlagen	12.500,00
B. Umlaufvermögen	90.079,49	101.600,87
I. Forderungen und sonstige Vermögensgegenstände	17.401,16	40.023,78
II. Kassenbestand, Bundesbankguthaben, Guthaben bei Kreditinstituten und Schecks	72.678,33	61.577,09
Aktiva	125.203,49	105.493,87

Passiva
	31.12.2022 EUR	31.12.2021 EUR
A. Eigenkapital	105.493,59	98.669,41
I. Gezeichnetes Kapital	25.000,00	25.000,00
II. Kapitalrücklage	49.041,72	49.041,72
III. Gewinnvortrag	24.627,69	56.323,41
IV. Jahresüberschuss	6.824,18	-31.695,72
B. Rückstellungen	5.206,00	4.000,00
C. Verbindlichkeiten	14.503,90	2.824,46
Passiva	125.203,49	105.493,87

Anhang

Allgemeine Angaben zum Jahresabschluss

Angaben zur Identifikation der Gesellschaft laut Registergericht

Firmenname laut Registergericht:	RAYY GmbH
Firmensitz laut Registergericht:	Köln
Registereintrag:	Handelsregister
Registergericht:	Köln
Register-Nr.:	HRB 97279

Angaben zu Bilanzierungs- und Bewertungsmethoden

Bilanzierungs- und Bewertungsgrundsätze

Das Sachanlagevermögen wurde zu Anschaffungs- bzw. Herstellungskosten angesetzt und, soweit abnutzbar, um planmäßige Abschreibungen vermindert.

Die planmäßigen Abschreibungen wurden nach der voraussichtlichen Nutzungsdauer der Vermögensgegenstände linear vorgenommen.

Forderungen wurden unter Berücksichtigung aller erkennbaren Risiken bewertet.

Die sonstigen Rückstellungen wurden für alle weiteren ungewissen Verbindlichkeiten gebildet. Dabei wurden alle erkennbaren Risiken berücksichtigt.

Verbindlichkeiten wurden zum Erfüllungsbetrag angesetzt.

Gegenüber dem Vorjahr abweichende Bilanzierungs- und Bewertungsmethoden

Beim Jahresabschluss konnten die bisher angewandten Bilanzierungs- und Bewertungsmethoden im Wesentlichen übernommen werden.

Ein grundlegender Wechsel von Bilanzierungs- und Bewertungsmethoden gegenüber dem Vorjahr fand nicht statt.

Angaben zur Bilanz

Angaben zu Forderungen gegenüber Gesellschaftern

Der Wert der Forderungen gegenüber Gesellschaftern beläuft sich auf 939,86 EUR (Vorjahr: 15.244,28 EUR).

Sonstige Angaben

Durchschnittliche Zahl der während des Geschäftsjahrs beschäftigten Arbeitnehmer

Die durchschnittliche Zahl der während des Geschäftsjahres im Unternehmen beschäftigten Arbeitnehmer betrug 2.

Unterschrift der Geschäftsführung

Köln, 6.9.2023

Jens Heinen

sonstige Berichtsbestandteile

Angaben zur Feststellung:
Der Jahresabschluss wurde am 06.09.2023 festgestellt.

Register documents

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

GET/v1/fetch-document

View the document API

Website studiorayy.com

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 RAYY GmbH. Include fiscal years and sources.\n\nentity_id: f59f6db0173e44ee9a83a7fe71c01a06",
    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 RAYY GmbH. Include fiscal years and sources.

entity_idf59f6db0173e44ee9a83a7fe71c01a06

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