Changelog
What changed in /v1, newest first. Breaking changes link to the migration guide.
/v1 changes in place. A breaking change is marked breaking, and the
migration guide has every one of them, old next to new. An old name that
keeps working for a while says so on every response with Deprecation and Sunset headers.
19 November 2026
GET /events/{event_id}finds older events. An event a company's history lists (GET /events?subject_id=) is found by its id whatever its age; before, an event older than about six months answered404. The price is unchanged.- A lookup that finds no company or several is refunded. A job started with
subject_lookupthat endscompany_not_foundorcompany_ambiguousnow gives back its 25 credits:credits.refundedshows 25. The candidates are unchanged. - A lookup job carries its outcome in
lookup. Breaking for lookups. Every job haslookup:nullfor a job started with a company id, else{outcome, candidates, candidates_has_more}whereoutcomeispending,matched,not_foundorambiguous. Several matching companies are no longer inresult.candidates: they arelookup.candidates(at most 10, withcandidates_has_more), andresultisnullunless the job succeeded. A candidate is a company:{object, id, name, register, city, status, subject_lookup}.idis our company id when we hold the company, elsenull;registerhas the court (code,name),type,number,formattedandcountry;subject_lookupis the criteria to send toPOST /jobsfor that company: the court, register type and number when the court is in our court directory (that names exactly one company), otherwise the name, register type and, when known, the city, which can match more than one company again. The failure codes staycompany_ambiguousandcompany_not_found. Every job also carriessubject_lookup(nullfor a company-id job). The migration guide has old next to new. - The value lists of a job can grow.
status_details.running.stage,status_details.failed.code,status_details.canceled.reason, and a missing document'sreasonandcodeare strings with documented known values, not closed enums. Treat a value you do not know like the fallback each field names. Jobstatusand the register types stay closed. Prefer: wait=NonPOST /jobs. SendPrefer: wait=N(1 to 55 seconds) and the call waits for the job. A job that reaches a final status in time answers201 CreatedwithLocationandPreference-Applied: wait=N; otherwise202 Acceptedas before, withLocationandRetry-After. WithoutPrefernothing changes.- MCP:
start_register_jobtakes anidempotency_key. An optional key (1 to 255 characters) sent asIdempotency-Key, so a retried call returns the same job instead of charging twice.get_register_jobreturnslookupwith the candidates and theirsubject_lookupto pass to the nextstart_register_job.
18 November 2026
- A job for a company we do not hold yet.
POST /jobstakessubject_lookupinstead ofsubject_id: the company'sname(required) and, optionally,register_court,register_type,register_number(needsregister_court) andcity. The job searches the register by name. When it finds one company, the company is stored and its documents are fetched as for asubject_idjob; the job'ssubjectthen carries the newcmp_id. Otherwise it fails withcompany_not_foundorcompany_ambiguous(result.candidateslists up to 10 matches, with asubject_idwhere we already hold the company). A lookup costs 25 credits; the charge stays when it endscompany_not_foundorcompany_ambiguous, and other failures are refunded. A lookup job cannot be canceled while queued. - MCP: register jobs. The MCP server has two new tools:
start_register_job(a company id, or a lookup by name; the same price asPOST /jobs) andget_register_job(free). They need the new scopesjobs:writeandjobs:read; an existing connection asks you to reconnect once to grant them. See MCP. - Transparenzregister extracts, connections and files. You can order the Transparenzregister's own extract of a
legal person with your own register account.
POST /connectionsstores a live login (the register's e-mail and password, never returned) or a test connection;POST /transparency-register/extractsorders an extract byekrnorcompany(Prefer: wait=55waits up to 55 seconds, else202withLocationandRetry-After); the statuses arequeued,pending,succeeded,failedandcanceled. Files are read by theirfile_id atGET /files/{file_id}/content. An open extract is canceled (refunded) or a final one redacted withPOST .../cancelandPOST .../redact; the data and files are deleted 30 days after the extract ended. The webhook eventstransparency_register.extract.succeeded,.failedand.canceledcarry no personal data. An extract costs 25 credits, charged only when it succeeds, a test extract too. The register bills its own 1,65 EUR per retrieved document to your own Transparenzregister account (live connections only). Five new problem codes start withtransparency_register_. The guide has the steps.
17 November 2026
- A job that brought none of the documents it was asked for is refunded. A
refresh_documentsjob whose register failed to hand out every requested document type still succeeds (the company record was refreshed), and its 25 credits are refunded in full:credits.refundedshows 25. - A document the register did not hand out because of a technical problem is
register_not_answering. When the register reports a technical problem and did not hand out a document,result.missing_documentsnames that documentregister_not_answering; ask again later; the job's other documents are served. - A company carries its consolidated head count.
GET /companies/{company_id}hasconsolidated_employee_estimate, the same shape asemployee_estimate: how many people the company and its subsidiaries employ, estimated by Registercheck from the consolidated accounts.change.vacanciesisnull. It isnullwhen there is no consolidated head count. The company in a KYB report, a verification, an answer or a job's result carries the key asnull. The price is unchanged. If you validate responses against a saved copy of the contract, update it, becausecompanyallows no other properties. An estimate'schangemay now span one or two fiscal years (to_year-from_yearis 1 or 2). - A company carries an employee estimate.
GET /companies/{company_id}hasemployee_estimate: how many people the company employs, estimated by Registercheck, as a range (min,median,max), aconfidence, when it was computed (as_of) and, where known, how the count changed between two years (change). It is not register data and not an official figure. It isnullwhen there is no estimate; estimates cover active GmbH, UG, AG, SE and KGaA and their "& Co." partnerships. The company in a KYB report, a verification, an answer or a job's result carries the key asnull. The price is unchanged. If you validate responses against a saved copy of the contract, update it, becausecompanyallows no other properties. - A holder filed under a foreign register carries that register's country. On a shareholder's or a
holder's
holder_as_filed.register, a register that is not one of the six German register types now hastype: nulland the register's own country (an Austrian FirmenbuchFNisAT). Before, the raw prefix was sent as the type, with countryDE, which a strict client rejects. The register's German spellings map to their type:HR BisHRB,HR AisHRA,GenRisGnR.formattedkeeps the register as filed. - The candidates of a
409 register_identity_ambiguousnow carry each company's published id (cmp_…) (breaking for a client that validatescandidates[].idas a UUID), as every other answer does; the raw UUID they carried before is the form deprecated since October 2026 and refused after 2026-12-31. The migration guide has the change. - The
409 register_identity_ambiguousdetail now namessubject_id. - A financial statement says whether its positions were withheld.
positionswasnullboth when a filing had not been read and when its reading failed the accounting check.GET /companies/{company_id}/financial-statementsnow carriespositions_status:read(the lines are served),not_read(no reading is served), orwithheld.positions_withheld_reasonisfailed_accounting_self_checkwhen the status iswithheld, andnullotherwise.positionsis unchanged: the lines whenread,nullfornot_readandwithheld.positions_statusisnullwhen it could not be checked on this request; ask again. The price is unchanged. If you validate responses against a saved copy of the contract, update it, because a statement allows no other properties. - A purpose the register does not state is
null. Where the register states no business purpose (most e.K., and many KG, OHG and GmbH & Co. KG),purposecarried the register's placeholder,"---". It is nownullon a company (GET /companies/{company_id}, the KYB report,POST /companies/verifyand/answers), on a formation, and in thedataof acompany.purpose.changedevent (itssource.textkeeps the register's wording as written). A purpose the register states is published verbatim, as before. - A job that keeps waiting on an unavailable register now ends after 15 minutes. A refresh job that is still
retrying15 minutes after it was created fails withregister_unavailableand its credits are refunded, so it no longer holds an open-job slot for up to an hour while a register keeps refusing. Ask again later; the fetch itself keeps trying in the background. - The rate-limit headers are in the OpenAPI document. Every successful response declares
X-RateLimit-Limit,X-RateLimit-RemainingandX-RateLimit-Reset, which were sent but not declared, so a generated client can read them.X-RateLimit-Resetis an ISO 8601 timestamp. Nothing about the limits changed. - A succeeded job names the documents it was asked for and does not hold.
result.missing_documentslists each asked type thatresult.documentsdoes not, in the order it was asked.not_in_registermeans the register's file holds none of that type (a GmbH without a filed Satzung, a closed sheet's current extract).not_retrievedmeans the register lists one, or we could not tell, and this job did not get it; ask again later.codeis the failure recorded for that document, ornullwhen nothing was recorded. A document the register still holds unchanged stays indocuments, with the date it was first retrieved. - The KYB report and a company's history carry the courts' insolvency publications. The
KYB report has an
insolvencysection: the publications of insolvenzbekanntmachungen.de (§ 9 InsO) matched to the company by register court, type and number and by name, each with itskind,stage,published_on,court,file_numberandkept_until, shown until its last day under InsBekV § 3. A company's events include onecompany.insolvency.recordedper publication, withsourceinsolvency_publication. They are not on the market-wide feed or on monitors. The KYB report's price is unchanged. - A financial statement lists the lines it prints.
positionson a financial statement is every balance-sheet and income-statement line of the published filing, in the order and outline it was printed, with figures in full currency units. It isnulluntil that filing has been read (financial statements). - A company's shareholders say when the register lists a newer list. When the register lists a
shareholder list newer than the one served,
extract.newer_filingon a company's shareholders and in the KYB report's shareholders section names that list'sdateand whether its refresh isqueuedorwaiting. The key is absent when the list served is the register's newest. The refresh costs nothing extra. - A person shareholder carries the birth date the filing states. On a company's shareholders, the
ownership tree and the KYB report,
holder_as_filed.birth_dateof a person is now the date of birth the shareholder list states; it was alwaysnullbefore. On a person's holdings it staysnull. - The company filter refuses a negative capital.
company.capital.gteandcompany.capital.lteonPOST /search/companies/filtertake 0 or more (share capital in euros). A negative bound answers400 validation_failednaming the field, uncharged.
16 November 2026
- A shareholder event names the two lists it compared.
company.shareholder.added,company.shareholder.removedandcompany.shareholding.changedcarrycurrent_list_dateandprevious_list_date: the register date of the newly filed list, and the register date of the stored list it was compared with. Either isnullwhen that date is unknown. Both are null for events stored before this field was released (2026-11-16).effective_dateis still the day the list was read.
14 November 2026
registration_datefor more companies whose sheet came from another court. When a carried-over sheet states no "Tag der ersten Eintragung" but names the register it came from,registration_dateis now that register's first entry, followed up to three registers back. No existing value changes; about 15% of the companies that answerednullnow have a day.founding_dateno longer carries a Beginn written with the month, either. About 800 more companies had a "Beginn" written as "1. Juli 2001", or an earlier entry's Beginn, as theirfounding_date. It is nownull, and the day is incommencement_date, which now also reads a Beginn written with the month name.founding_dateno longer carries a partnership's Beginn. About 45,000 companies, almost all OHG and KG, had the day the register states as their "Beginn" infounding_date. It is nownullfor them, and the same day is incommencement_date. A founding date that any register entry states as the articles (Gesellschaftsvertrag, Satzung) stays as it was, and so does every founding date that differs from the Beginn.- A company's first register entry, and the Beginn the register states.
registration_dateis now the "Tag der ersten Eintragung" the register states for a sheet carried over from an earlier register (the paper register, or another court after a move), for example 1977 rather than the 2005 day the sheet was rewritten. A carried-over sheet that does not state that day now answersnullinstead of the transfer day. The newcommencement_dateis the start of business the register states ("Beginn", mostly for OHG and KG),nullwhere it states none. Neither is a founding date:founding_datestays the founding contract. Both are onGET /companies/{company_id}, the KYB report,POST /companies/verifyand/answers, at no extra cost.
13 November 2026
-
A current representative without own words takes sole or joint from the register entry that states them. A holder whose own words are not on the current printout but in a later register entry publishes
typefrom that entry withbasis: entry,text: nulland no § 181 release (the register history holds those words as read, not as printed). -
Start dates now also come from the register history's numbered entry that opened a current mandate. A current role whose own numbered entries give no appointment takes that day as
appointed_date. A former role does not, and a role whose own numbered entries say the appointment ended still publishes none. -
A representative's start date comes only from a numbered register entry. A managing director's or board member's
appointed_dateis the day of the register's numbered entry that appointed them, as for a Prokura. A holder known only from the current printout, whose listing carries no entry number, now hasappointed_date: null-- the printout's own day was the day of its last entry, not of the appointment. Roles are ordered by the published date, undated last. -
The KYB report carries a sanctions screening.
GET /v1/companies/{company_id}/kyb-reporthas a newsanctionssection: an automated name match of the company and of the people in its current roles and shareholder list against the official EU, UN, OFAC and UK sanctions lists, with the list versions screened and each hit's list, entry, result (matchorpossible) and reasons. A match needs a second identifier, such as the same register number or the same full birth date. The report still costs 50 credits. -
Registered associations (e.V.) now carry their signing authority. A board member's
signing_authorityis published on every surface that already carried it for other forms. Until now every role at an association publishednull. At a registered associationsoleis published only where the register's own words say so in a standard wording -- a rule that makes every board member sign alone, or the holder's own standard words; any other sole reading publishestype: nullwith its basis and text. At a registered associationtogether_withisnull: who signs with a joint holder is not read there yet.
12 November 2026
- Joint signing authority names its co-signers.
signing_authority.together_withlists who signs together with a joint holder: each entry is an office (type) and how many of its holders (count, orall), any one entry being enough -- for example a Gesamtprokura "gemeinsam mit einem Geschäftsführer oder einem anderen Prokuristen" reads[{"type": "managing_director", "count": 1}, {"type": "authorized_signatory", "count": 1}]. It isnullwhen the holder is not joint or the register names no office. - More Prokura roles carry their signing authority. A Prokurist the register's sources store twice -- once from the current printout without its wording, once from the change history with it -- now reads
signing_authorityfrom the register's wording instead of publishingnull. Where the stored rows disagree on the wording and the register's entries cannot tell which is newer, or the row with the wording has ended or records a later change, it staysnull, and a grant the register ended no longer lends a current Prokura its dates. - A company's first register entry and its former names. A company's
registration_dateis now the day of its first register entry (it was alwaysnull), and the newprevious_nameslists the names it no longer bears, oldest first, each withuntil, the day that name ended: onGET /companies/{company_id}, the KYB report,POST /companies/verify,/answersand a refresh result (GET /jobs/{id}).[]means none;nullmeans they could not be read on this read. - A shareholder as the filing names it. Each shareholding on a company's shareholders, the
ownership tree and the KYB report carries
holder_as_filed: a company with its seat, country and register (a foreign register too, such as Delaware's, with its number), or a person with the name and place the filing states.holderstays the bare link. On a person's or a company's own holdings,holder_as_filednames the holder only. - The KYB report's documents say when we retrieved them. Each document reference carries
retrieved_at, as/documentssays it, and the report lists the newest articles of association (articles_of_association). - A company's history lists what the register changed.
GET /companies/{company_id}/eventsno longer lists an entry whose stored value is empty, a legal-relationship or note entry without text, or an undated shareholder-list change, and lists each appointment once per person and role. The legal form is the one the register states; a UG that becomes a GmbH by a new name is a name change, and the old name is inprevious_names. - A residence with a slash stays whole. A place of residence such as "Wünschendorf/Elster" or "Frankfurt/Main" is no longer cut at the slash on roles and person records; only a foreign residence written as "town / country" is split into town and country. Stored residences were corrected.
- A role's name needs at least 3 letters or digits. On a role condition,
name,first_nameandlast_namewithcontainsneed at least 3 letters or digits.an,a b,---and a value of only spaces answer400 validation_failednaming the field, before anything is charged. A company name and a shareholder name still take 2.equalsandstarts_withon a role name stay refused. - Prokura roles carry their dates. An
authorized_signatoryrole'sappointed_dateis the date of the register entry that granted the Prokura, and an ended Prokura'sended_datethe entry that ended it --nullwhere no numbered register entry dates that grant. The order of a company's roles is unchanged: representatives first, then the Prokuristen.
11 November 2026
- A refresh job also checks for a newer shareholder list. For a GmbH or UG, a
refresh_documentsjob that asks the register now also checks it for a newer shareholder list (Gesellschafterliste) and reads one, at no extra cost: the job'sdocumentsthen include it, and/companies/{id}/shareholdersserves it. - A Prokura's § 181 release is
trueonly in full.signing_authority.self_dealing_exempton a Prokura role was alsotruewhen the register lifted only one of the two prohibitions of § 181 BGB, most often with "mit sich als Vertreter eines Dritten" (acting for a third party at the same time). Such a partial release now publishesnullwith the register's words intext, as it already did for every other role (companies). - Signing authority on every representative role. Each current role at
GET /companies/{company_id}/roles, in?expand=roles, the KYB report and an on-demand refresh result (GET /jobs/{id}) carries asigning_authoritythat says how its holder may sign —nullfor every role at a registered association. A registered association is its stored legal form (an e.V. or a wirtschaftlicher Verein); only where no legal form is stored, a VR register or "e.V." or "eingetragener Verein" in its name counts. The reading is not certified for associations yet (a later release may certify them). On the company surfaces (a company's roles list and?expand=roles, the KYB report,/answers, a refresh result) every representative role of a company whosestatusisterminatedpublishessigning_authority: null. A person's own roles (/persons/{person_id}/roles) read the holder's own entry words alone, as before. Company surfaces publish no signing authority when the source withheld every checked text or predates the field. A person's roles publish no entry words that the source withheld and none that hold a date. On a company surface, own words that hold a date answer nothing for that role —signing_authorityis{type: null, basis: "entry", self_dealing_exempt: null, text: null, real_estate_power: null, limited_to_branch: null}(every field null except basis "entry"; neither the rule nor the statute answers). A Prokura's dated wording publishessigning_authority: null. A refresh result (GET /v1/jobs/{job_id}) whose render withheld someone publishessigning_authority: nullfor that role. The stored words are dropped before the role is read. Where the company's privacy rules withheld anyone on its lists — a representative or a Prokura holder — only the holder's own entry words answer. A rule whose answer depends on an amount or a kind of deal (land, loans) answers nothing for a role it moves between alone and joint; a role that signs jointly either way staysjoint. Words that negate a power, or deny a § 181 BGB release, state nothing and grant none. Beyond that:type(sole/joint) with a newbasisnaming which of three sources answered — the holder's own entry words (entry), the company's printed general representation rule (general_rule) or the statute of the legal form (law). A rule answers a role only where it names that role's organ or names no organ, and is read against the holders of the organ it names; a rule that states representation plainly blocks the statute for every role, also one it does not name.self_dealing_exemptistrueonly for a full release from § 181 BGB; a partial one staysnull, and a release read from the rule publishes with the rule's words intext. Words that exclude the holder from representation, or that negate a power, keeptype: nullwith the words intextandbasis: entry; words that deny a § 181 release grant none. A rule whose answer depends on an amount answers nothing for a role it moves between alone and joint (a role that signs jointly either way staysjoint). Where the company's privacy rules withheld anyone on its lists (a representative or a Prokura holder), only the holder's own entry words answer. A former role, and every role on a person's own list (GET /persons/{person_id}/roles), answers from the holder's entry words alone — a row the company's Sperrung check did not keep publishes nothing of the entry. A Prokura's authority is read from its own wording as before and now also names itsbasis.POST /answers'may_act_aloneis read from the same role the roles list builds for the same payload, so the two cannot disagree; an answer that rests on the statute carriesmediumconfidence and names the statute in its details. The company record'srepresentation_ruleis the rule the roles applied: the newest printout's rule, from its meta row; only where no meta rule exists does the record fall back to the latest entry's (the roles list carries no events, so there the meta row's rule is the only source).
10 November 2026
-
Document downloads cost 10 credits.
GET /v1/documents/{document_id}/contentandPOST /v1/documents/{document_id}/linkseach cost 10 credits; the new link endpoint is free while a paid link this key made for the same document is still live. A link fromPOST /v1/documents/{document_id}/linksserves the file throughhttps://files.registercheck.de/d/…for up to 60 minutes and 20 downloads;GET /v1/documents/{document_id}/contentstill answers302with a link that expires after 5 minutes. -
The MCP server's
get_documentuses the new link. It callsPOST /v1/documents/{document_id}/links(10 credits; free while the link lives), reads the file from files.registercheck.de, and returns the same link for the user's browser. Continuing a long document withoffsetwithin those 60 minutes is free. -
A plan refusal names the plan that allows it.
403 destination_requires_plan,job_requires_planandmonitor_limit_reachedcarryfeatureandrequired_plan;monitor_limit_reachedalso carriesused(errors). -
GET /accountlists itsfeatures: each feature a key can be refused, whether this workspace has it, and the plan that turns it on when it does not. -
A destination says when the plan stops it (
requires_plan):"business"for a Slack channel or webhook while the workspace is on a smaller plan,nullotherwise. It turns back tonullby itself after an upgrade. -
A monitor says how and when it reports:
check_schedule,next_check_at,paused_atandcounts_toward_limit. A monitor created with an API key reports as soon as a change is detected (check_schedulenull). -
One free feed of all your company monitors' events:
GET /events?monitored=true, ordered and paged likemonitor_id. -
Event types carry a
severity,criticalornormal. -
Test a webhook destination:
POST /destinations/{destination_id}/testsends one signed sample delivery whosetestistrue. It is free, at most 10 an hour, sent once and never counted towards switching the destination off. -
Slack and webhook destinations come with Business and Scale.
POST /destinationswith"channel": "slack"or"webhook"answers403 destination_requires_planon a smaller plan, as the plans describe. A Slack channel or webhook you set up earlier stays set up: an event of a monitor whose workspace has a smaller plan is not sent to it (its delivery isskipped), and it receives again after an upgrade. E-mail destinations are not affected (details). -
Claude and ChatGPT can connect to the MCP server with a workspace API key. On the Registercheck sign-in page an assistant's connection now offers Mit API-Schlüssel verbinden: the connection then acts with that key, its limits and its workspace's credits, and ends when the key is revoked (details). The key never signs anyone in to the web app.
-
The MCP server reads a register document in the chat.
get_documentreturns a PDF's text layer or structured register data as XML, and gives a download link on files.registercheck.de for scans without a text layer.
9 November 2026
- The MCP server accepts a workspace API key. AI platforms that cannot sign in with OAuth, such as
Langdock, can connect to the Registercheck MCP server
with an API key sent as
Authorization: Bearer, once the workspace allows it: API-Schlüssel für KI-Plattformen (MCP) in the workspace settings, off by default. A tool costs what the same/v1call costs, charged to the key's workspace. Nothing changes for/v1or for OAuth connections. - A company's register history, entry by entry.
GET /companies/{company_id}/register-entrieslists the register court's own record of a company, newest entry first: oneregister_entryper entry, with its running number on the register sheet, the day it was entered and every change it made.GET /companies/{company_id}/eventsstill flattens the same history into one event per change.
7 November 2026
- Smaller fixes found while checking the documentation against the API.
GET /companies/{company_id}/documentsandGET /companies/{company_id}/financial-statementsanswer a merged company id with301 company_merged, like the record and its other sub-resources; they answered404. A survivor that is no longer public still answers404.HEAD /healthandHEAD /openapi.jsonanswer likeGET, without a body; they answered405.- A search monitor's
recent_matches.sample[].event_typeuses the namesGET /eventspublishes (company.role.added, notcompany.officer.appointed). - Responses no longer carry an undocumented header that named a supplier. The documented
X-RateLimit-*headers are unchanged. - A
400from the company filter describes the filter only, and a400fromGET /eventsnames each parameter in this API's spelling (effective_date[gte], noteffective_date_gte). A402for one credit says "1 credit". Branch oncode, never ondetail.
6 November 2026
- WZ 2008 on the company record.
industries_wz2008lists the company's WZ 2008 classification (Klassifikation der Wirtschaftszweige, Ausgabe 2008) from section to subclass, beside the WZ 2025industries. It is derived from the WZ 2025 subclass by the official Destatis correspondence; where one WZ 2025 subclass corresponds to several WZ 2008 subclasses, Registercheck picks one from the registered business purpose. - A merged company id redirects only to a public company.
GET /companies/{company_id}, its sub-resources andGET /events?subject_id=answer301 company_mergedfor a merged id as before, unless the surviving company is no longer public: then the merged id answers404 not_found, like an id that was never there, and names no company. - The KYB report, verify, answers, ownership, beneficial owners, refresh results and find follow who the register says is in office.
Like the role lists, a person registered under a changed name is listed once, under the name the
register uses now: the KYB report,
POST /companies/verify,POST /answers, the general partners onGET /companies/{company_id}/shareholdersandGET /companies/{company_id}/ownership-tree, the computed beneficial owners, a refresh job's company result, and the officer aPOST /companies/findhit names. Verify still matches a signatory by a name she was registered under before. - Role lists follow who the register says is in office. A person registered under a changed name
is listed once, under the name the register uses now.
GET /companies/{company_id}/roles, the company'scounts.current_roles,?expand=roles,GET /persons/{person_id}/rolesandGET /persons/{person_id}/holdingsfollow that decision for who is current and when the office ended. - Jobs: fewer refusals and duplicate fetches, honest failure codes. An open job of the same company now comes
back free even when the workspace is at its 10-open or 120-per-hour limit; at a limit, a company whose data is
fresh enough still gets its stored answer, and only a job that needs the register is answered
429 rate_limited. Under the limits, a job asked right after a company read joins the refresh that read started instead of asking the register twice.result.register_entries_addednow counts the register entries a refresh added, and isnullwhen they could not be counted. A failed job names its cause:register_unavailablewhen the register did not hand over a document, and the newduplicate_company_record(asking again cannot help) when the company's register entry is held under another company id.status_transitions.running_atis set for a job that ran, also when it ended quickly. Job webhooks no longer carrysentry-traceorbaggageheaders.
The documentation was checked against the live API and corrected throughout. Features the API already served are now documented:
- Documented: verify a customer's details.
POST /companies/verifycompares a company's name, register identity and address — one line intext, or fields incompany— and optionally a signatory with the register, and runs the risk checks you name (status,insolvency,sanctions,ubo). 4 credits, plus 8 withubo; a company that is not found (404) or ambiguous (409) is not charged. Check a customer walks through it. - Documented: ask one question about a company.
POST /answersanswers one of six kinds of question (representation,beneficial_owner,officers,shareholders,seat,status) from register data. 8 credits; a question outside the six kinds answers422 question_not_supportedand is not charged. - Documented: download a register document.
GET /documents/{document_id}/contentanswers302with a link to the file that expires after 5 minutes, for 1 credit; each document'slinks.downloadnames it. Documents. - Documented: search monitors.
POST /monitorswith apromptor afilterinstead of a company watches new companies, or changes at companies, that match a search. Creating one is free; its matches are sent by e-mail to the API key's owner, at 1 credit per match delivered. A search monitor carries nometadata. Search monitors. - Documented: search by street address. The company filter's
company.addressmatches the registered address:street, withpostal_codeandcityto narrow it. Filtering. - Documented: a radius around an address or a town.
POST /companies/findreads a radius in words ("im Umkreis von 5 km um Marienplatz 1, München") intonear, andnear_placenames the place it measured from.
These changes were already in effect before this date; the reference now describes them:
- A search monitor's prompt names its events. Without
event_types, the events a prompt names are the ones it watches: "Insolvenzen in Berlin" watches insolvencies, "Kapitalerhöhungen bei GmbHs in München" capital changes. A prompt that names no criterion a search can hold (an industry, a federal state, a city, a legal form or capital), such as "Kapitalerhöhung" alone, answers422 prompt_not_understood, which always carriesunrecognized. - A court change names the former court as
previous. Incompany.register_court.changedevents, a court the register's wording calls the former one ("bisher Amtsgericht X …, nunmehr Amtsgericht Y") is nowdata.previous, neverdata.current: such an entry used to publish X as the current court, and now publishespreviousX andcurrentY. A court change noted when a register sheet was rewritten names only the former court; itscurrentisnull. - Monitored companies count per workspace. The limit on monitored companies — what a resume
with
PATCH /monitors/{monitor_id}is checked against — counts the monitors of the workspace, created in the app by any of its members, not the person's across every workspace they belong to. The limit is the workspace's plan's; on the free plan (Gratis) it is the free plan's in a personal workspace and0in a team workspace, where resuming a dashboard monitor answers403monitor_limit_reachedwithlimit0until the workspace takes a paid plan. Otherwise pausing or deleting one of the counted monitorsGET /monitorslists makes room.GET /account'smonitorsare the workspace's. Monitors created with an API key or through the MCP server still never count. - A key whose person may only read in its workspace cannot write. Creating, changing and deleting
lists, list items, monitors and destinations, and changing a formation's
metadata, answer403forbiddenwhen the role the API key's person holds in the key's workspace may only read, or when the workspace is closed. Nothing is changed and nothing is charged. Each of these operations now declares that403, andPOST /destinationsalso declares the403destination_requires_planit already answered. - A key whose person may only read spends no credits. Every operation with a price — reads
included, and through the MCP server — answers
403forbiddeninstead of charging when the API key's person may only read in the key's workspace, or when the workspace is closed, whatever the balance (not402). Nothing is charged. Every priced operation now declares that403. - Where the roles of a company come from.
GET /companies/{company_id}/rolesand the KYB report's roles part carry anextract(status,fetched_at,document_id) naming the register extract the roles are read from.statusisparsed(read),processing(on file, being read),not_fetched(never fetched),failed, orunknown— the API's own word for a moment when it could not ask where the data stands.document_idandfetched_atarenullwhen the company's roles were written from more than one filing; the extract describes the company's whole roles record, whateverstatusandrole_typethe page filters by. The roles of a person (GET /persons/{person_id}/roles) sayextract: null: no one filing is behind them. - A shareholders page says when its list was fetched.
fetched_atonGET /companies/{company_id}/shareholdersis the moment the filed shareholder list was fetched, whenever the page's holders all come from that one list; otherwise it isnull, asdocument_idalready was. - Both changes add properties; nothing is removed or renamed. A client that validates responses
strictly against an older copy of this spec will see
extractas a property that copy does not know (our schemas admit no unknown names); keep your copy of the spec current, or allow additional properties when you validate.
5 November 2026
- Jobs: ask the register for a company's current documents.
POST /jobswithtype: "refresh_documents"and asubject_idanswers202with a job;GET /jobs/{job_id}says when to look again (Retry-After) until the job issucceeded,failedorcanceled, andGET /jobslists your jobs. A succeeded job'sresultholds its documents, and the refreshed company for 24 hours. 25 credits when the register is asked; 10 when the data we hold is newer thanmax_age_seconds(retrieval: stored); nothing when this workspace already has that job open; refunded in full when it endsfailed, orcanceledbefore the register is asked (POST /jobs/{job_id}/cancel); the balance must hold 25 when a job is asked for. Scale and Enterprise; any other plan gets403 job_requires_planand is never charged. A webhook destination whoseenabled_eventslistsjob.succeeded,job.failedorjob.canceledis told when a job ends, signed as every webhook is. - A person's roles list an office once.
GET /persons/{person_id}/roles,?expand=rolesandGET /persons/{person_id}/holdingsalso listed an older copy of some offices, from the register's first import in early 2025: listed ascurrent, with no dates andholder_as_registered: null, next to the same office as the company lists it. Where the company's list holds the office for the person, the copy is gone; a Prokura now carries the role id the company's list uses. - Every role carries its holder's date of birth and place of residence, as the register entry states them.
holder_as_registeredon everyrole(GET /companies/{company_id}/roles,?expand=roles, the KYB report,GET /persons/{person_id}/roles):name,birth_date,city(Wohnort). It isnullwhen a company holds the role, or, on a person's list (/persons/{person_id}/roles,?expand=roles), when the entry cannot be shown: the company withholds that row, or its check could not be made. A birth date withheld at the person's request staysnull. No extra charge. Before, this took oneGET /persons/{person_id}per holder and was out of reach for a holder with no person id. If you validate responses against a saved copy of the contract, update it, becauseroleallows no other properties.
3 November 2026
- A gGmbH and a gUG are legal forms of their own (breaking for every filter that names
gmbhorug): a non-profit GmbH carrieslegal_form: "ggmbh"and a non-profit UGlegal_form: "gug"(new), instead ofgmbhandug.GET /legal-formslistsgugnext toug. A company filter onlegal_form: ["gmbh"]no longer returns gGmbHs, and["ug"]no longer returns gUGs; to keep the set you had, ask forgmbhandggmbh(orugandgug). Companies already registered carry their own code too. The migration guide has the pairs. - A company's tax IDs have their own endpoint, and come with the company on request.
GET /companies/{company_id}/tax_idslists the USt-IdNr. and the Steuernummer the company prints on its own Impressum, each typed as one of Stripe's tax ID types (eu_vat,de_stn), with the page and the date it was read. It costs 10 credits, and nothing when no tax ID can be shown.GET /companies/{company_id}?expand=tax_idsadds the same list to the company at no extra charge;expand=roles&expand=tax_idsasks for both. The values are not checked with any tax authority, and the Steuernummer of a sole trader or another form that identifies a natural person is never shown.
30 October 2026
- Find and the company filter cost 1 credit per 10 companies they return, nothing when they find none.
POST /companies/findandPOST /search/companies/filterwere charged for the results a call asked for, ⌈limit/10⌉, also when fewer or none came back. They now cost ⌈returned/10⌉: a page of 3 is 1 credit, an empty one is free. Your balance must still hold ⌈limit/10⌉ before the call.x-credit-cost-persays so withcounted: returned.
29 October 2026
- Finding companies reads cities, trades and English better, and the same way each time.
POST /companies/findsearches a city by the name the register writes ("Frankfurt" asFrankfurt am Main, "Koeln" and "Munich" asKölnandMünchen), can search a trade by the WZ 2025 code the official keyword index gives it ("Bäckereien in Berlin" searches10.71.0), and otherwise by a word stem of the business purpose ("Elektriker in Köln" searches the purpose for "Elektriker");interpreted_filtershows which. An English activity is read as a German purpose stem. An activity the prompt names that the reading could not take comes back inunrecognized, instead of being left out without a word. The same prompt reads the same way for as long as its reading is kept. - The company filter refuses what its schema refuses, uncharged.
neartakes latitudes from -90 to 90, longitudes from -180 to 180 and a radius of 1 m to 200 km; a list criterion (legal_form,status,register_court,register_type,industry) holds at least one item and an industry code at most 10 characters;containstakes 2 characters or more andstarts_with1; a date is a calendar day asYYYY-MM-DD. Each answers400 validation_failednaming the field. Such input was answered and charged before (an empty list matched every company, a date that is no day answered503). - The company filter costs 1 credit per 10 requested results, and a page holds up to 1,000 companies.
POST /search/companies/filtercost 25 credits a page of at most 100; it is now priced asPOST /companies/findis, ⌈limit/10⌉ a call (a page of 100 is 10 credits, of 1,000 is 100). Itslimitnow takes 1–1,000 (default 20, unchanged); the filter still serves its first 10,000 companies. - Finding companies searches the activity a prompt names.
POST /companies/findsearches an activity by the WZ 2025 code whose official title describes it ("ambulanter Pflegedienst" is86.94.1Ambulante Pflegedienste), else by a word stem of the register's business purpose (company.purpose), instead of guessing a whole industry, which answered entire sectors.interpreted_filtershows what was searched, andignoretakespurposeto leave the purpose out.
26 October 2026
- A person search hit carries the full date of birth. Each person in
GET /search/personsandGET /search/suggestionsnow hasbirth_dateandbirth_monthnext tobirth_year, as the person's record (GET /persons/{person_id}) states them. A person whose date of birth is withheld has all threenull, as on the record, and a personGET /persons/{person_id}answers404for is not listed. When the dates cannot be read, the search answers503service_unavailablewithRetry-Afterand nothing is charged. - The MCP server finds people. The Registercheck MCP server has a new tool,
search_persons(1 credit, likeGET /search/persons): people by name, optionally by year of birth and city, each with their date of birth and city. A person inlist_company_roles,list_company_shareholdersandget_companynow carriesperson_id, the id that search answers with. Register text such as an event's wording is passed on as the register states it; its dates of birth are no longer cut to the year.
17 October 2026
- The MCP server charges what the API charges. A tool call through the
Registercheck MCP server now costs the credits of the
/v1call it makes, like the same call made with an API key:search_companiesandlist_company_documents1 credit,get_company,list_company_roles,list_company_shareholders,list_company_eventsandcreate_monitor10. Until now onlylist_eventscost credits there.POST /monitorsthrough a connection of the MCP server costs 10 credits, which free credits do not pay. Nothing changes for API keys. - A monitor created through the MCP server is one created with an API key. It costs 10 credits
and no longer counts against the companies your plan monitors; resuming it is never refused for
that limit.
GET /account'smonitorscounts the monitors created in the dashboard only. - Ten times the credits in every plan. Starter includes 1,000 credits a month, Business 10,000 and Scale 100,000, at the same plan prices. The free plan's 50 credits stay as they are.
16 October 2026
- Resuming a monitor can be refused.
PATCH /monitors/{monitor_id}with{"status": "active"}answers403monitor_limit_reachedwhen resuming would monitor more companies than the plan allows. Only active monitors count; monitors created with an API key never do.
15 October 2026
- The reference-data lists answer the page envelope (breaking):
/legal-forms,/courts,/role-types,/industries,/event-typesand/event-groupsnow answer{ "object": "page", "data": [...], "next_cursor": ... }like every other list, instead of{ "object": "list", "data": [...], "has_more": false }. They takelimit(1–100) andcursorlike every other list, andlimitis optional: omit it to receive the whole list in one page,next_cursornull— every vocabulary,/industries' 2,030 codes included. The data and its order are unchanged, and they stay free. The switch is hard: there is no transition period and noDeprecationheader. See Pagination. - Which
match_confidenceto rely on. People recommends using person links at 0.80 or above. On 2026-10-15 links stored at 0.75, 0.70 or 0.60 whose register entry did not match the linked person were corrected: they now point to the matching person at 0.95 or 0.90, or to a new person at 0.95. - A monitor's event is dated when the monitor reports it. On
GET /events?monitor_id=, in a delivery and in a webhook body,created_atis the moment the monitor reported the event — the same instant in all three. For a monitor created with an API key that is within seconds of the moment the change reached Registercheck, as before. A monitor created in the dashboard reports at its check time; polling oncreated_at[gte]still finds every event. - Destinations carry a
role:own,account_inboxorroute, saying which events a destination receives. Aroute's cadence cannot be changed (409route_endpoint). Creating a destination with aroute's address makes itown. - Webhook deliveries of dashboard monitors. A dashboard monitor that delivers to a webhook sends each
event as a delivery with
cadenceinstant, listed byGET /deliveries. Its e-mail and Slack summaries are not API deliveries and are not listed. - The account inbox's cadence sets how often dashboard monitors check when none was chosen for them:
instantthe plan's fastest,dailydaily,weeklyandmonthlyweekly.
10 November 2026
- New API keys. A key created from this date starts with
rc_prod_and is 107 characters long. Keys created before 2026-11-10 start withregistercheck_and keep working. A revoked key stops working with the next request.
9 October 2026
- Computed beneficial owners.
GET /companies/{company_id}/beneficial-ownersreturns abeneficial_owner_analysis: each natural person the filings compute as qualifying, with the path and the multiplied percentage.statusiscomplete,partialornone_found.gwg_above_25(more than 25%) andamlr_at_least_25(25% or more) are separate flags.fictitious_rule_appliesfollows the GwG test only, and stays false when a holder was withheld, an unidentified person could still reach 25%, or that person shares a name with an identified holder and together they could reach 25%. A person is identified by one linked person record, or else by the same full name and birth date (matched_by). Managing directors stay on/roles. 25 credits. Computed from register filings; may be incomplete. Not a Transparenzregister extract. - KYB report.
GET /companies/{company_id}/kyb-reportassembles the company record, the first page of current roles, the first page of shareholders, the ownership tree to depth 3, and references to the shareholder list and the register extracts. 50 credits, charged once. A part that cannot be completed is a 503 and is not charged, including a shareholder list that is still being extracted. A privacy check that cannot be completed is a 500, as on the other company routes. The report does not include computed beneficial owners;GET /companies/{company_id}/beneficial-ownerscomputes them. The report is computed from register filings. It is not an extract from the Transparenzregister, and it is no substitute for your own due diligence. - Ownership tree, levels 2 and 3.
GET /companies/{company_id}/ownership-treefollows linked companies for thedepthyou ask (1, 2 or 3).effective_percentageis the product of the percentages along the path, equal to the holding's own percentage at depth 1 and rounded half up to four decimal places further down. A cycle, and a company that holds itself, is flagged and not followed.unresolvedsays where the chain ends (foreign_entity,entity_not_linked,stock_corporation,no_shareholder_list,extraction_pending,depth_limit,cycle,self_holding,percentage_withheld).completeandtruncatedsay whether that list is finished. Still 10 credits. Asking still starts at most one extraction, for the company you asked about. Companies further up are read from ownership already stored.
8 October 2026
- A person's
age.GET /persons/{person_id}includesage: whole years as of today in Europe/Berlin, computed frombirth_dateon each request and never stored. It isnullwhen the date is missing, in the future, or the age would be over 120. - Filter companies by age.
roles.conditions[].ageselects representatives, and Prokuristen when the condition also setsrole_typeto["authorized_signatory"]. Kommanditisten takeshareholders.conditions[].agewithtype: ["limited_partner"]. Bounds are whole years from 0 to 120. An age on a role by itself, and a Kommanditist'sageorbirth_dateby itself, answers400: combine it with a narrowing criterion, for example a name, a register, a location or another company filter. A shareholder criterion counts;statusandholder_typealone do not. Plain shareholders have no date of birth, soagethere answers400.
October 2026: one model
Breaking. /v1 uses one word for each thing the register holds, the same in every path,
field, id and page of these docs. The glossary lists the words; the
migration guide lists every change.
- Ids say what they name:
cmp_…for a company,per_…for a person, and so on for every kind. A raw UUID is still accepted until 31 December 2026. An id of the wrong kind answers400 validation_failedinstead of404. - The workspace id on
GET /accountis awsp_…id derived one way from the app's id (org_personal_…), which it was before: it no longer matches anything the app shows. No request takes a workspace id. - One page envelope for every list and search:
{object: "page", data, next_cursor}, paged withcursor.starting_after,ending_before,page,has_moreandnext_pageare gone. - One reference shape for a company or person:
party,{object, id, name}. - Roles:
/companies/{company_id}/rolesand/persons/{person_id}/rolesreplace/companies/{id}/officersand/persons/{id}/positions, with oneroleobject. Every list that narrows by role takesrole_type; the role's own field istype. - Holdings of a person:
/persons/{person_id}/holdings, the person's shareholdings. - Ownership tree:
/companies/{company_id}/ownership-treereplacesdepthon/shareholders. A shareholding names itsholder(wasowner), and a page of shareholders carriesextract(wasavailability). - Events:
/eventswithobject: "event", asubject,datashaped by the event type, and assource, the register entry it was read from (the document for a shareholder list or annual accounts;nullwhen the entry's number is not known). Its previous path,/company-events, keeps answering until 31 December 2026. - Monitoring:
/destinations(was/notification-endpoints, withaddressfor the address),/deliveries,/event-typesand/event-groups(was/monitor-event-types)./alertsis gone: read what a monitor matched at/events?monitor_id=(free), and what was sent at/deliveries. A monitor's webhook body is adeliveryholding its events. A destination has acadence: instant, or for e-mail and Slack a daily, weekly or monthly digest at 07:00 in the workspace's time zone, and can be a Slack channel. - Role events:
company.officer.appointed,.changedand.removedarecompany.role.added,company.role.changedandcompany.role.removed. - Lists:
/listswithlistandlist_item(was/collections). - Search answers
summaryobjects with atype(companyorperson);citymoved toaddress.city, so apart fromobjectandtypea summary is a subset of its full record. - The filter's role criteria are named
roles(wereofficers), and a condition's role type isrole_type(wasrole).namematches a person's first, last or full name as well as a company holder's name, andfirst_nameandlast_namematch one of a person's names. - Errors: a field that fails validation is
400 validation_failedwitherrors[]on most operations;/monitorsandexpandstill answer a field error as400 invalid_request, itsdetailnaming the field. Renamed paths answer410 endpoint_retirednaming the replacement. - Credits:
Registercheck-Credits-Chargedis on every response to a call made with a key. Prices did not change. nameis the search term onGET /formationsandGET /eventstoo;qkeeps working on/formationsuntil 31 December 2026.- The reference is grouped by the first segment of the path (the reference lists under Reference
data,
/healthunder Platform), and lists only what is served.
October 2026: before the one-model release
- Search takes
name.GET /search/companies,/search/personsand/search/suggestionsread the search term fromname.qkeeps working until 31 December 2026. GET /eventslists register events across all companies, andGET /events/{event_id}reads one. The previous path,/company-events, keeps working until 31 December 2026.- One
statusrule. The company record, search results, suggestions and the filter derivestatusthe same way, always lowercase:active,liquidation,terminatedorunknown. - Event types renamed (breaking for monitors that name them):
company.shareholder.changediscompany.shareholding.changed, andcompany.shareholders.changediscompany.shareholder_list.changed. The old names answer400naming the new one. - Insolvency and other register entries are monitorable, in the groups
insolvency,conversionandother_entries.
2 October 2026
legal_formreplaceslegal_form_codeonGET /formations.
1 October 2026
- The
/v1naming revision: the formations feed (/formations) replaces/search/new-registrations.
17 September 2026
- The
/v1reference replaces the reference of the earlier API.