fetch_document
ChatGPTRetrieve a current or chronological register excerpt, shareholder list, articles of association, or structured register content for a resolved company entity_id. PDFs are returned as resource content; SI XML as text, with filename, content type and size metadata. Costs 15 credits; limited to 5 requests per minute. Use get_shareholders for structured ownership data.
fetch_person
ChatGPTOpen on your Max plan. Retrieve a person’s registered company roles with AI web evidence, using both the person’s name and an associated company to disambiguate. Requires Plus, Pro or Max; check get_account_status first. Costs 15 credits including AI, plus 5 for optional shareholdings when present. Use find_companies_by_person to find associated companies.
find_companies_by_financials
ChatGPTFind companies by revenue, employee count, profit, assets, ratios or registered capital. Use base EUR amounts (10 million = 10000000) and decimal ratios (30% = 0.3). Financial-statement criteria require filed data. Returns active companies by default. Costs 1 credit per page.
find_companies_by_industry
ChatGPTFind German companies in an industry, with optional location, legal-form and size filters. Supply an industry in words or WZ2025 codes; locally resolved codes appear in derived.industry. Returns active companies by default, newest registrations first. Costs 1 credit per page.
find_companies_by_management
ChatGPTOpen on your Max plan. Find companies by the age of their active managing directors or the number of registered officers. Ages are whole years today; optional location and company filters narrow the results. Returns active companies by default. Requires Pro or Max; check get_account_status first. Costs 1 credit per page.
find_companies_by_ownership
ChatGPTOpen on your Max plan. Find owner-managed or family-owned companies, ownership structures, or companies matching a shareholder name, age or stake. Owner-entry criteria are combined with structure criteria; match context identifies the matching entries. Returns active companies by default. Requires Pro or Max; check get_account_status first. Costs 1 credit per page.
find_companies_by_person
ChatGPTFind companies where a named person is registered as an officer or owner. Matching entries appear in the result context; an optional birth date helps distinguish namesakes. Officer searches work on every plan; owner searches require Pro or Max, so check get_account_status first. Costs 1 credit per page.
find_companies_in_insolvency
ChatGPTOpen on your Max plan. Find companies by insolvency proceeding status, phase or opening dates, with optional location, legal-form and industry filters. For a feed of individual events, use get_recent_insolvency_events. Requires Pro or Max; check get_account_status first. Costs 1 credit per page.
find_companies_near
ChatGPTFind companies within a radius of supplied latitude and longitude, ordered nearest first. Returns active companies by default. For a city or postal code without coordinates, use the location filters on other company finders. Costs 1 credit per page.
find_industry_codes
ChatGPTFind candidate WZ2025 industry codes from an industry name in German or English, or a code prefix. Returns codes with German and English labels for use in company searches. Searches the bundled index locally and consumes no API credits.
find_newly_registered_companies
ChatGPTFind companies registered within a date range, optionally narrowed by location, legal form or industry. Returns newest registrations first. Use this for regional company lists; get_recent_new_registrations provides the register-event feed. Costs 1 credit per page.
find_recently_changed_companies
ChatGPTFind companies with recent changes to management, address, name, purpose, capital, governance or branches. Narrow by date and location; results show the most recent activity first and default to active companies. Available on every plan. Costs 1 credit per page.
find_related_companies
ChatGPTFind companies linked through registered corporate relationships: holdings, general partners, mergers, splits, enterprise agreements or squeeze-outs. Use get_shareholdings when ownership- stake details are needed. Returns active companies by default. Available on every plan. Costs 1 credit per page.
get_account_status
ChatGPTCheck your handelsregister.ai plan, subscription and purchased-credit balances, next expiry, and available features and event topics. Use before gated tools or a costly sequence of lookups. This call is free; capability summaries are advisory and the API remains authoritative.
get_annual_financial_statements
ChatGPTRetrieve complete annual financial statements as Markdown with metadata for reading and analysis. Responses can be large; use get_financials when only annual KPIs are needed. Feature charge: 5 credits when data exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_annual_financial_statements_html
ChatGPTRetrieve complete annual financial statements in HTML when the original markup is needed. For reading and analysis, use get_annual_financial_statements for Markdown. Responses can be large. Feature charge: 5 credits when data exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_balance_sheet
ChatGPTRetrieve hierarchical assets and liabilities for one financial year or all years on file. If a requested year is unavailable, the result lists available years. Feature charge: 3 credits plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_company_features
ChatGPTRetrieve several requested company data sections in one upstream fetch with one 5-credit base charge. Feature prices: financial_kpi/publications 1 each; related_persons 2; balance_sheet_accounts and profit_and_loss_account 3 each; insolvency_publications, annual_financial_statements, annual_financial_statements__html, shareholders and shareholdings 5 each; ubos and news 10 each; mergers_and_acquisitions 20. website_content adds no feature charge but enables the 20-credit AI mode. Realtime adds 10 credits where supported. Use dedicated tools for a single section.
get_company_overview
ChatGPTRetrieve a company’s identity, status, legal form, purpose, registration, address, contact details, capital history and industry classification. Use an entity_id from search_organizations for a reliable match. Costs the 5-credit base, without additional feature charges; optional AI and realtime modes add surcharges.
get_company_snapshot
ChatGPTGet a company overview, annual financial KPIs and current management together. Use this for a broad company introduction after resolving its entity_id. Costs 8 credits when all sections return data, before any optional AI surcharge; availability depends on filings and plan.
get_financials
ChatGPTRetrieve annual revenue, net income, employee counts, totals and ratios for a company. Optionally select years; results identify available years and fields restricted to higher plans where applicable. Missing figures are unavailable, not zero. Feature charge: 1 credit plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_insolvency_publications
ChatGPTRetrieve insolvency court publications for one company, with dates, case numbers and available details. Use get_recent_insolvency_events for events across companies. Feature charge: 5 credits when data exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_mergers_and_acquisitions
ChatGPTRetrieve one company’s mergers, splits, enterprise agreements, counterparties and current control relationships. Use get_recent_mergers_and_transformations for events across companies. Feature charge: 20 credits when data exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_news
ChatGPTRetrieve recent news about a company, including article titles, sources, publication dates and URLs. Use for news coverage rather than official register history. Feature charge: 10 credits plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_profit_and_loss
ChatGPTRetrieve profit-and-loss accounts for one financial year or all years on file. If a requested year is unavailable, the result lists available years. Feature charge: 3 credits plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_publications
ChatGPTRetrieve official commercial-register publications and structured history for one company. Use the get_recent_* feeds for events across companies. Feature charge: 1 credit plus the 5-credit base on an upstream fetch; optional AI adds a surcharge. Realtime mode is unavailable.
get_recent_capital_changes
ChatGPTRetrieve register events for changes to share, liable, conditional or authorised capital. Excludes capital assigned at founding. Filter by dates or company IDs; no location filter. Available on every plan. Costs 20 credits per page, including empty pages.
get_recent_company_changes
ChatGPTRetrieve register changes for up to five companies, newest first. Resolve entity_ids with search_organizations, then optionally select topics and dates. When topics are omitted, the result reports plan-accessible coverage and locked topics. Costs 20 credits per page, including empty pages. Reuse cursors only with the same query.
get_recent_company_closures
ChatGPTRetrieve register events for dissolutions, completed liquidations, deletions and extinguishments. Excludes continuations and reversed deletions. Filter by dates or company IDs; no location filter. Available on every plan. Costs 20 credits per page, including empty pages.
get_recent_insolvency_events
ChatGPTOpen on your Max plan. Retrieve insolvency openings, protective measures and terminations across companies. Filter by dates or company IDs; no location filter. Use get_insolvency_publications for one company’s history. Requires Pro or Max; check get_account_status first. Costs 20 credits per page, including empty pages.
get_recent_management_changes
ChatGPTRetrieve register events for appointments, departures and changes of directors, board members and holders of procuration. Excludes liquidator appointments and pure data corrections. Filter by dates or company IDs; no location filter. Available on every plan. Costs 20 credits per page, including empty pages.
get_recent_master_data_changes
ChatGPTRetrieve register events for changes to company names, seats, business addresses and register courts. Includes court transfers and excludes founding assignments. Filter by dates or company IDs; no location filter. Available on every plan. Costs 20 credits per page, including empty pages.
get_recent_mergers_and_transformations
ChatGPTOpen on your Max plan. Retrieve register events for mergers, splits, legal-form conversions, asset transfers, enterprise agreements and squeeze-outs. Filter by dates or company IDs; no location filter. Use get_mergers_and_acquisitions for one company’s history. Requires Max; check get_account_status first. Costs 20 credits per page, including empty pages.
get_recent_new_registrations
ChatGPTRetrieve a page of new commercial-register entries, newest announcement first. Filter by dates or up to five company IDs. For a regional company list, use find_newly_registered_companies; this feed has no location filter. Available on every plan. Costs 20 credits per page of up to 20 events, including empty pages.
get_related_persons
ChatGPTRetrieve a company’s managing directors, board members, holders of procuration and other registered officers, including tenures and representation powers. Returns current officers by default; optionally include former officers. Feature charge: 2 credits plus the 5-credit base; optional AI adds a surcharge. Realtime mode is unavailable.
get_search_filter_reference
ChatGPTLook up supported company search filters, value formats, units, sort fields, legal forms, federal states and plan requirements. Request one filter group or the complete reference. Reads the bundled vocabulary locally and consumes no API credits.
get_shareholders
ChatGPTRetrieve current shareholders, contributions and ownership ratios, together with historical lists where available. Use fetch_document for an official shareholder-list PDF. Feature charge: 5 credits when a list exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_shareholdings
ChatGPTRetrieve companies in which the selected company holds stakes, with ownership shares and as-of dates where available. For a person’s holdings, use fetch_person with include_shareholdings. Feature charge: 5 credits when data exists, plus the 5-credit base; mode surcharges may apply.
get_signal_details
ChatGPTRetrieve the full details of one register event using its signal ID, including parties, register-entry text and the company profile. Use after a feed result when its compact summary is insufficient. Costs 20 credits per lookup.
get_ubos
ChatGPTRetrieve a company’s ultimate beneficial owners and ownership paths, including unresolved owners and coverage information. Preserve these limitations when summarizing the result. Feature charge: 10 credits when data exists, plus the 5-credit base on an upstream fetch; mode surcharges may apply.
get_website_content
ChatGPTRetrieve a company’s website content as structured Markdown. This lookup always enables AI mode, adding 20 credits to the 5-credit company base even though the website-content feature itself is free. Optional realtime mode adds its surcharge; availability depends on the upstream lookup.
search_organizations
ChatGPTFind German companies by name, register number or keyword. Returns entity_id values for follow- up company and document lookups. Add location or legal-form filters to distinguish namesakes. Costs 1 credit per page, or 5 with semantic ai_mode; up to 30 matches per page.
search_organizations_advanced
ChatGPTCombine raw API filters for company searches that the dedicated finders do not cover. Consult get_search_filter_reference for supported fields and plan gates. Filters are validated locally before an upstream request. Costs 1 credit per page, or 5 with semantic ai_mode, which cannot be sorted.