API referenceSearch
Find persons by name
Looks up natural persons by name, optionally narrowed by birth year and city.
Costs 1 credit.
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer rc_live_….
In: header
Query Parameters
q*string
Full name or part of it.
Length
2 <= length <= 200birth_year?integer
Year of birth.
Range
1850 <= value <= 2100city?string
City of residence as registered.
Length
length <= 100limit?integer
Page size.
Range
1 <= value <= 100Default
20page?string
The next_page token of the previous search result.
Length
length <= 500Response 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/persons?q=string"{ "object": "search_result", "has_more": true, "next_page": "string", "total_count": 0, "data": [ { "object": "person_summary", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "birth_year": 0, "city": "string" } ]}