List new formations
Companies whose first register entry is a new registration (a Neugründung): not a registered-office
move, a conversion or a merger. One formation per company; its id is the company's id.
Order. Newest Registertag first, fully specified and stable:
registration_date descending, then the order we found them in, then the company's UUID
descending. Ties never reorder between pages.
Window. The list covers the last 180 days of Registertage. An
registration_date[gte] older than that answers 400 validation_failed. Retrieving
one formation (GET /formations/{formation_id}) works outside the window.
Completeness. Registertage before 2026-09-09 are incomplete.
Polling. A formation becomes visible once the company's first register entry has been
written, and the list is refreshed about once a minute. Some are found a day or more
after their Registertag and sort into the middle of the list. Do not poll on
registration_date: it misses rows. Poll on created_at instead, the moment a formation
became available here:
GET /formations?created_at[gte]=<T minus 10 minutes>&limit=100, sending each page'snext_cursorascursoruntil it isnull;- deduplicate by
id; - set
Tto the largestcreated_atyou received.
Delivery is at-least-once and eventually consistent: the 10-minute overlap re-reads rows
you already have, which is what deduplicating by id is for.
Costs 10 credits per page.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_prod_….
In: header
Query Parameters
First Registertag to include. Without any registration_date or created_at bound, the
list covers the last 30 days; with any of them it covers the whole 180-day window. Older than 180 days answers 400 validation_failed.
^[0-9]{4}-[0-9]{2}-[0-9]{2}$dateLast Registertag to include.
^[0-9]{4}-[0-9]{2}-[0-9]{2}$dateOnly formations that became available through this API at or after this instant. Poll on this.
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$date-timeOnly formations that became available through this API at or before this instant.
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$date-timeOnly these legal forms. Repeat the parameter for several (legal_form=gmbh&legal_form=ug). GET /legal-forms lists them all.
items <= 40Only these federal states, as ISO 3166-2 codes (DE-BY). Repeat the parameter for several.
items <= 16Only these registered offices (Sitz). Exact match, ignoring case and umlaut spelling
(Muenchen matches München). Repeat the parameter for several.
items <= 50Minimum registered capital in EUR, as a decimal (25000 or 25000.00). A formation without EUR capital is excluded when either capital bound is set.
^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$Maximum registered capital in EUR, as a decimal.
^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$Words that must all appear, ignoring case and umlaut spelling, in the name, the registered office, the city of the business address, the court, the register number, the business purpose or the name of one of the company's officers.
2 <= length <= 100Deprecated alias of name, served until 2026-12-31. It searches exactly as name
does, and every response to a request that uses it carries the Deprecation and
Sunset headers. Giving both name and q is a 400 naming q.
2 <= length <= 100Page size, 1 to 100.
1 <= value <= 10020The next_cursor of the previous page; leave it out for the first page. Opaque: pass it
back as it came. A cursor from another list, or from the same list with other filters,
answers 400 validation_failed naming cursor.
1 <= length <= 2000Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.registercheck.de/v1/formations" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "data": [ { "id": "cmp_01hxn3rys1fh58w4d1pb1x9s85", "object": "formation", "registration_date": "2026-09-30", "created_at": "2026-09-30T13:52:00Z", "company": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s85", "name": "Beispiel Festival GmbH" }, "name": "Beispiel Festival GmbH", "legal_form": "gmbh", "register": { "court": { "code": "D2601", "name": "Amtsgericht München" }, "type": "HRB", "number": "999998", "formatted": "Amtsgericht München HRB 999998", "country": "DE" }, "state": "DE-BY", "registered_office": "München", "address": { "street": "Festwiese 3", "postal_code": "80335", "city": "München", "care_of": null, "formatted": "Festwiese 3, 80335 München", "country": "DE" }, "capital": { "amount": "25000.00", "currency": "EUR" }, "purpose": "Planung und Durchführung von Beispielfestivals.", "metadata": {} } ]}