# Search people

The ability to search for a person by name, company name or company number.

Results can be filtered by birthDate (format must be YYYY-MM).

Results are ordered by matching relevance.

Endpoint: GET /person/search
Version: 2.0.0
Security: ApiKeyAuth

## Query parameters:

  - `searchText` (string, required)
    Not case-sensitive.

  - `birthDate` (string)
    format must be YYYY-MM

## Response 200 fields (application/json):

  - `idPerson` (integer, required)

  - `profileLink` (string, required)

  - `name` (string, required)

  - `birthDate` (string,null)

  - `activeRoles` (array)

  - `activeRoles.companyName` (string)

  - `activeRoles.companyNumber` (string)

  - `activeRoles.idCompany` (integer)

  - `addresses` (array)

  - `addresses.line1` (string,null)

  - `addresses.line2` (string,null)

  - `addresses.line3` (string,null)

  - `addresses.line4` (string,null)

  - `addresses.town` (string,null)

  - `addresses.postcode` (string,null)

  - `score` (number)

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)