Find persons by name
Looks up natural persons by name, optionally narrowed by birth year and city. Each hit
carries the date of birth as registered (birth_date), as the person's record states it.
Pages by limit and cursor. A cursor holds this search's parameters, not its page size:
the next page may ask for another limit. A cursor sent with other parameters answers
400 validation_failed naming cursor.
Costs 1 credit.
Authorization
bearerAuth Your API key, sent as Authorization: Bearer rc_live_….
In: header
Query Parameters
Required. Full name or part of it.
Matching is by words, ignoring case: every word you give must appear in the
name, in any order, and the last one also matches as the start of a word
(Beisp finds Beispiel). Small typos are tolerated. A fragment from the middle
of a word does not match. When no name contains every word, names that contain
fewer of them are returned instead.
2 <= length <= 200Deprecated 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.
2 <= length <= 200Year of birth.
1850 <= value <= 2100City of residence as registered.
length <= 100Page size.
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
curl -X GET "https://api.registercheck.de/v1/search/persons?name=Mustermann" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "next_cursor": null, "total_count": 1, "data": [ { "object": "summary", "type": "person", "id": "per_01hxn3rys1fh58w4d1pb1x9s82", "name": "Erika Mustermann", "birth_date": "1970-01-01", "birth_year": 1970, "birth_month": 1, "address": { "city": "Musterstadt" } } ]}