---
title: "Search for a person in screening databases"
method: POST
path: "/search-screening-person"
---

# Search for a person in screening databases

`POST /search-screening-person`

Use this endpoint to search for individuals in global screening databases including sanctions, PEPs (Politically Exposed Persons), regulatory actions, and more.

**Parameters:**
-   `companyKey` _(string, required)_ - The company's secret key.
-   `query` _(object, required)_ – The parameters for querying the database.
    -   `fullName` _(string, required)_ – Full name of the individual.
    -   `birthdayTimeFrom` _(string, optional)_ – The start date and time of the birthday range in ISO 8601 format.
    -   `scoreThreshold` _(integer, required)_ – The minimum score required for the query results.
-   `offset` _(integer, optional)_ – The number of items to skip from the beginning of the results.
-   `limit` _(integer, optional)_ – The maximum number of items to return in the query results.
    

**Entities glossary:**
-   `**Sanctioned Entity**`: Companies, individuals, or other entities that have been designated by a government to prohibit specific interactions with them.
-   `**Sanction-linked Entity**`: Entities, including companies and individuals, that have a direct relationship with a sanctioned entity. This also includes companies that are indirect subsidiaries of sanctioned entities, regardless of the percentage ownership held by the sanctioned entity.
-   `**Counter-sanctioned Entity**`: Entities listed on sanctions lists from non-democratic countries, often targeting pro-democracy activists, journalists, and human rights advocates.
-   `**Debarred Entity**`: Companies or individuals that have been excluded from public procurement, typically due to committing fraud in the execution of a government contract.
-   `**Politician (Politically Exposed Persons)**`: Individuals who currently or previously held a position of political influence.
-   `**Close Associate**`: Family members and key business associates of politically exposed persons (PEPs). These individuals are often used as nominees or front-people to hide illicit financial gains.
-   `**Person of Interest**`: Individuals under scrutiny due to public interest, who do not meet the common definitions of politically-exposed persons and are not sanctioned.
-   `**Regulator Action**`: Companies that have been subject to enforcement action by an industry regulatory body.
-   `**Regulator Warning**`: Companies that have been placed on a warning or alert list by an industry regulatory body.

## Request body

- SearchScreeningPerson
  - `companyKey` string
  - `query` object
    - `birthdayTimeFrom` string, date-time
    - `fullName` string
    - `scoreThreshold` number
  - `offset` number
  - `limit` number

## Response `200`

Success

- SearchScreeningPersonResponse
  - `result` object[]
    - `personId` string
    - `entityType` string
    - `name` string
    - `score` number
    - `topics` string[]

## Other responses

- `400` — ArgumntError

---

[API](https://skmtc.net/identomat/apis/generated-api.md) · [All operations](https://skmtc.net/identomat/apis/generated-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/identomat/generated-api/revisions/cda4b2b11372/schema)