registercheckby openlaw group
API referenceFormations

List new formations

GET
/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:

  1. GET /formations?created_at[gte]=<T minus 10 minutes>&limit=100, sending each page's next_cursor as cursor until it is null;
  2. deduplicate by id;
  3. set T to the largest created_at you 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
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_prod_….

In: header

Query Parameters

registration_date[gte]?string

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.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Formatdate
registration_date[lte]?string

Last Registertag to include.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}$
Formatdate
created_at[gte]?string

Only formations that became available through this API at or after this instant. Poll on this.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$
Formatdate-time
created_at[lte]?string

Only formations that became available through this API at or before this instant.

Match^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$
Formatdate-time
legal_form?array<>

Only these legal forms. Repeat the parameter for several (legal_form=gmbh&legal_form=ug). GET /legal-forms lists them all.

Itemsitems <= 40
state?array<>

Only these federal states, as ISO 3166-2 codes (DE-BY). Repeat the parameter for several.

Itemsitems <= 16
registered_office?array<>

Only these registered offices (Sitz). Exact match, ignoring case and umlaut spelling (Muenchen matches München). Repeat the parameter for several.

Itemsitems <= 50
capital[gte]?string

Minimum registered capital in EUR, as a decimal (25000 or 25000.00). A formation without EUR capital is excluded when either capital bound is set.

Match^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$
capital[lte]?string

Maximum registered capital in EUR, as a decimal.

Match^(0|[1-9][0-9]{0,11})(\.[0-9]{1,2})?$
name?string

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.

Length2 <= length <= 100
q?string
Deprecated

Deprecated 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.

Length2 <= length <= 100
limit?integer

Page size, 1 to 100.

Range1 <= value <= 100
Default20
cursor?string

The 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.

Length1 <= length <= 2000

Response 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": {}    }  ]}