registercheckby openlaw group
API referenceSearch

Find companies by name or register identity

GET
/search/companies

Looks up companies by name, by register identity (court, register type and number), or both. A register identity is not guaranteed to be unique — about 1% of identities are shared by more than one entry — so this always returns a list.

Requires q or register_number.

Costs 1 credit.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

q?string

Company name or part of it.

Length2 <= length <= 200
register_court_code?string

Register court code, for example D2601 (Amtsgericht München).

Match^[A-Z][0-9]{4}$
register_type?string

Register type.

Value in

  • "HRA"
  • "HRB"
  • "GnR"
  • "PR"
  • "VR"
  • "GsR"
register_number?string

Register number without the register type, for example 292661 or 12345 B.

Lengthlength <= 20
status?array<>

Only companies with one of these statuses.

city?string

City of the registered address.

Lengthlength <= 100
limit?integer

Page size.

Range1 <= value <= 100
Default20
page?string

The next_page token of the previous search result.

Lengthlength <= 500

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/search/companies"
{  "object": "search_result",  "has_more": false,  "next_page": null,  "total_count": 1,  "data": [    {      "object": "company_summary",      "id": "3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55",      "name": "Beispiel Analytics GmbH",      "status": "active",      "legal_form_code": "gmbh",      "register": {        "court": {          "code": "D2601",          "name": "Amtsgericht München"        },        "type": "HRB",        "number": "299999",        "display": "Amtsgericht München HRB 299999",        "country": "DE"      },      "city": "München",      "incorporation_date": "2024-03-14"    }  ]}